Agent Plane CLI for task workflows, recipes, and project automation.
npm install agentplane



Agent Plane is a policy-driven framework for running LLM agents inside real repositories. It turns "AI magic" into an engineering process: explicit approvals, role boundaries, and a reproducible execution pipeline. The goal is simple: make agents boring, safe, and auditable.
- You want agents that behave predictably inside real repos.
- You need human approvals, clear roles, and traceable artifacts.
- You want guardrails by default, not optional add-ons.
- You want an offline-first CLI that keeps state local and inspectable.
Install and initialize the CLI:
``bash`
npm install -g agentplane
agentplane init
agentplane quickstart
Create your first task and run the workflow:
`bash`
agentplane task new --title "First task" --description "Describe the change" --priority med --owner ORCHESTRATOR --tag docs
agentplane verify
agentplane finish
Prefer npx instead of a global install?
`bash`
npx agentplane init
npx agentplane quickstart
- .agentplane/ is created with config, tasks, agents, and caches.AGENTS.md
- is created if missing and defines the policy/guardrails..agentplane/agents/
- Built-in agent definitions are copied into .agentplane recipes install ...
- Optional recipes can install additional agents when you run .
- Approval gates for plans and network access (configured in .agentplane/config.json)..agentplane/agents/
- Role boundaries (ORCHESTRATOR, PLANNER, CODER, INTEGRATOR, etc.).
- Agent definitions in ..agentplane/tasks/
- Task records in with a snapshot export in .agentplane/tasks.json.
- A visible, reproducible pipeline:
`text`
Preflight -> Plan -> Approval -> Tasks -> Verify -> Finish -> Export
- Policy-first execution with explicit approvals and guardrails.
- Role-based workflows for teams: ORCHESTRATOR, PLANNER, CREATOR, INTEGRATOR, etc.
- Two workflow modes: direct (single checkout) and branch_pr (worktrees + integration).
- Task tracking, verification, and exports baked in.
- Recipes for repeatable setup and automation.
`bash`
npm install -g agentplane
Or run without installing:
`bash`
npx agentplane --help
- Node.js >= 20
`bash``
agentplane --help
agentplane quickstart
agentplane config show
agentplane task list
agentplane task new --title "..." --description "..." --priority med --owner ORCHESTRATOR --tag docs
agentplane verify
agentplane finish
agentplane recipes list
- Documentation index: https://github.com/basilisk-labs/agentplane/tree/main/docs
- Workflow overview: https://github.com/basilisk-labs/agentplane/blob/main/docs/user/workflow.mdx
- CLI commands: https://github.com/basilisk-labs/agentplane/blob/main/docs/user/commands.mdx
- Project layout: https://github.com/basilisk-labs/agentplane/blob/main/docs/developer/project-layout.mdx
- Recipes: https://github.com/basilisk-labs/agentplane/tree/main/agentplane-recipes
- Issues: https://github.com/basilisk-labs/agentplane/issues
- Contributing: https://github.com/basilisk-labs/agentplane/blob/main/CONTRIBUTING.md
MIT