done-agent-pack

Done Agent Pack CLI — turn any folder into a Done-style agentic workspace for Claude Code, Cursor, Codex, Antigravity, and any agent that reads AGENTS.md.

Install

# Global install
npm install -g done-agent-pack

# Or run without installing
npx done-agent-pack init my-project

The CLI binary is named donepack to avoid colliding with the legacy done npm package.

Commands

donepack init [target]

Initialize a Done Agent Pack workspace.

donepack init                # initialize current directory
donepack init my-project     # create new dir and initialize it
donepack init --dry-run      # preview without writing
donepack init --force        # overwrite existing .done/
donepack init --mode EXISTING_REPO_MODE   # force a mode
donepack init --json         # JSON output

donepack status [target]

Print the current workspace state: detected mode, active phase, active ticket, open gates and risks.

donepack status              # status of current dir
donepack status my-project   # status of a specific dir
donepack status --json       # JSON output

donepack doctor [target]

Validate that the workspace contains a complete, well-formed pack.

donepack doctor              # health check of current dir
donepack doctor --json       # JSON output

Exits with code 1 if blocking issues (critical or high) are found.

donepack --version

Show CLI and pack versions.

donepack --version
# donepack v0.1.0
# pack v1.0.0

Compatibility

• Node 20 or higher.
• macOS, Linux, Windows.
• Designed for Claude Code first, but works with any agent that reads AGENTS.md.

Quick start

mkdir my-project
cd my-project
npx done-agent-pack init
# Open with your coding agent and start your first prompt:
# "Act with Done Agent Pack. I want to build <your idea>."

License

MIT