@aideps/cli

The CLI bridge for Aideps. Pulls Work Packets into your existing AI agent (Claude Code, Cursor, Codex, etc.).

Install

npm i -g @aideps/cli
# or, in a repo, just:
npx aideps <command>

Quickstart

# 1. Inside your repo
npx aideps init
# → walks you through pasting your agent token (aidp_live_...)
# → creates .aideps/config.json (commit this)
# → saves your token to ~/.aideps/credentials.json (do NOT commit)

# 2. List packets your team has created
aideps packet list

# 3. Pull a packet into your repo
aideps packet pull PKT-A4F9C2
# → writes .aideps/packets/PKT-A4F9C2.md

# 4. Tell your AI agent to use it
#    e.g. in Claude Code:
#    "use the packet at .aideps/packets/PKT-A4F9C2.md"

# 5. Start a run record so Aideps tracks progress
aideps run start PKT-A4F9C2 --agent claude_code

# 6. (optional) Log progress as the agent works
aideps run log <run-id> "implementing SAML routes"

# 7. When the agent opens a PR, mark complete
aideps run complete <run-id> --pr https://github.com/you/repo/pull/421

Commands

aideps init
aideps packet list
aideps packet show <PKT-XXXXXX>
aideps packet pull <PKT-XXXXXX>
aideps run start <PKT-XXXXXX> --agent <name> [--runtime <runtime>]
aideps run log <run-id> "<message>" [--kind <kind>]
aideps run complete <run-id> [--pr <url>] [--summary "<text>"]

Files

| File | Commit? | Purpose | |---|---|---| | .aideps/config.json | Yes | workspace + API URL — no secrets | | .aideps/packets/PKT-*.md | Up to you | packet markdown for the agent to read | | .aideps/decisions/ | Up to you | local decision log (synced to dashboard) | | .aideps/runs/ | No | local run cache (auto-gitignored) | | ~/.aideps/credentials.json | No (machine-scoped) | your agent token |