Install
The agent-first contract for Collections — intent
search, bounded active-only reads, --view full, and archive/restore/purge as separate lifecycle operations — needs @driftless-sh/cli ≥ 0.27.9. Run driftless --version to verify; reinstall with the command above to upgrade.The
usage command and commercial-intelligence allowance contract require
@driftless-sh/cli ≥ 0.28.0.Authenticate
Rundriftless login to open your browser to the Driftless dashboard, where you can copy your API key:
Install the agent skill
Install Driftless context instructions so coding agents automatically retrieve topics before editing:AGENTS.md and CLAUDE.md into your repo. Agents will see topic retrieval instructions every session.
Create your first topic
Driftless starts with topics: durable engineering memory anchored to the files and workflows where it matters.Set
DRIFTLESS_API_KEY for non-interactive environments. Set DRIFTLESS_API_URL only when targeting staging or a local API.Config File
The CLI stores its state in~/.driftless/config.json:
Command reference
Global flags
Environment Variables
Environment Variables
