Install
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
| Command | Flags | Description | Example |
|---|---|---|---|
login | --key <key> | Authenticate with API key | driftless login --key drift_xxx |
doctor | --json | 8 health checks | driftless doctor |
install-skill | none | Install AGENTS.md + CLAUDE.md | driftless install-skill |
Global flags
| Flag | Description |
|---|---|
--version / -v | Print version |
--help / -h | Full help |
<cmd> --help | Command-specific help |
Environment Variables
Environment Variables
| Variable | Description |
|---|---|
DRIFTLESS_API_KEY | API key (wins over config file) |
DRIFTLESS_API_URL | API server URL (default: https://api.driftless.icu/api/v1) |
