The adrive binary — a thin CLI for AgentDrive, the cross-agent artifact workspace with provenance and portable storage across Claude Code, Codex, Cursor, and LangGraph.

Install

npm i -g @adrive/cli
adrive init

Or use the one-line installer:

curl -fsSL agentdrive.sh/install | sh

adrive init opens a browser to log you in (no localhost server, polling-style), then auto-detects installed agent tools (Claude Code, Cursor, Codex CLI, Cline, Continue, Zed) and wires the AgentDrive MCP server into each.

Configuration

Stored at $XDG_CONFIG_HOME/agentdrive/config.json, falling back to ~/.config/agentdrive/config.json. The file is chmod 600. Schema:

{
  "api_url": "https://app.agentdrive.sh",
  "api_key": "agentdrive_live_...",
  "agent_id": "ag_...",
  "org_id": "org_...",
  "agent_platform": "cli",
  "default_workspace": "ws_..."
}

Commands

Command	Purpose
`adrive init`	First-run wizard: log in + wire MCP into every installed agent tool
`adrive auth login`	Open browser, log in, store API key
`adrive auth logout`	Wipe local credentials
`adrive auth status`	Show whether you're logged in + masked key
`adrive whoami`	Print principal info from the API
`adrive ls`	List workspaces
`adrive push <file> [--workspace ws] [--remote-path p]`	Upload a local file
`adrive pull <ws-id>/<path> [-o out]`	Download a file (stdout by default)
`adrive search <query> [--top-k N] [--platform claude-code] [--workspace ws]`	Semantic search across artifacts
`adrive context <task> [--limit N] [--workspace ws]`	Auto-pull artifacts relevant to a task
`adrive run-log [--status success	failure
`adrive billing`	Open the Stripe billing portal in your browser
`adrive plan`	Show current plan, usage, and quotas

-v / --version and --help work at every level.

Authentication

adrive uses Cursor-style polling auth — no localhost server:

adrive auth login calls POST /v1/auth/cli/start to get a short-lived auth URL.
The CLI opens the URL in your default browser. You complete the login in the dashboard (Google, GitHub, or email magic link).
The CLI polls GET /v1/auth/cli/poll?id=<id> every 1.5s for up to 10 minutes.
On success, the returned api_key is stored at chmod 600.

If the browser does not auto-launch (e.g. headless server, SSH session), the URL is printed prominently so you can open it manually.

Auto-detect + wire

adrive init looks for these config files and merges the AgentDrive MCP server entry in (preserving any servers you already have):

Tool	Config path
Claude Code	`~/.claude/mcp-servers.json`
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS), `%APPDATA%/Claude/claude_desktop_config.json` (Windows), `~/.config/Claude/claude_desktop_config.json` (Linux)
Codex CLI	`~/.codex/config.toml`
Cursor	`~/.cursor/mcp.json`
Cline	`~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` (or the Linux equivalent)
Continue	`~/.continue/config.json`
Zed	`~/.config/zed/settings.json`