CLI Commands Reference

All ADM CLI commands. Run from repo root: npm run cli -- <command> or adm <command> after npm link from cli/.

---

Account

Command	Description
adm account new	Create account (interactive prompts for company, industry, seats, headcount, ARR, ADM, notes)
adm account list	List all accounts with health, risk, ARR. Use --adm, --risk, --sort
adm account show	Full account detail: info, health score, ROI model, deployment plan. Pass account name as argument
adm account delete	Delete account and related data. Use --force to skip confirmation

---

Research & Intelligence

Command	Description
adm research	Run account research (web search + LLM). Requires ANTHROPIC_API_KEY. Use `--depth quick
adm competitive	Scan for AI tool signals (Copilot, Cursor, etc.). Requires ANTHROPIC_API_KEY. Pass account name as argument

---

Modeling

Command	Description
adm roi	Calculate ROI. Pass account name. Use --seats, --dev-cost, --velocity, --license-cost, --no-scenarios, --no-save
adm health	Compute health score. Pass account name. Use --interactive or --licensed, --weekly-active, --nps, --tickets, etc.
adm plan	Generate deployment plan. Requires ANTHROPIC_API_KEY. Use --seats, --pilot, --no-save
adm expansion	Generate expansion proposal. Use --current, --target, `--scenario conservative

---

Operations

Command	Description
adm qbr	Generate QBR. Requires ANTHROPIC_API_KEY. Use --quarter 2026-Q1
adm escalate	Generate escalation brief (interactive prompts for issue type, context, urgency). Pass account name
adm risk	Run risk detection (health trends + competitive signals). Use --weeks (default 12)

---

Portfolio

Command	Description
adm portfolio	Portfolio overview. Use --risk, `--sort health
adm portfolio at-risk	At-risk accounts only (critical + high risk) with recommended actions

---

Utility

Command	Description
adm playbook	Search playbook for objection handling. Pass query. Use --limit
adm status	Environment and connectivity check (MongoDB, Anthropic API, collection counts)

---

Cursor Command Mapping

Cursor Command	CLI Equivalent
/adm-research [company]	adm research [company]
/adm-roi [seats] [salary]	adm roi [company] --seats [N]
/adm-health [account]	adm health [company]
/adm-deploy [account]	adm plan [company]
/adm-qbr [account] [quarter]	adm qbr [company] --quarter [Q]
/adm-expansion [current] [target] [account]	adm expansion [company] --current [N] --target [N]
/adm-risk [account]	adm risk [company]
/adm-competitive	adm competitive [company]
/adm-progress	adm portfolio

See Cursor Commands Reference for full details.

---

MCP Tool Mapping

CLI Command	MCP Tool
adm research	adm_account_research
adm roi	adm_calculate_roi
adm health	adm_health_score
adm plan	adm_deployment_plan
adm qbr	adm_qbr_generator
adm escalate	adm_escalation_brief
adm expansion	adm_expansion_plan
adm risk	adm_risk_detector
adm competitive	adm_competitive_scan
adm playbook	adm_playbook_library
adm portfolio	adm_team_dashboard

---

Environment

• MONGODB_URI — required for persistence
• ANTHROPIC_API_KEY — required for research, plan, qbr, expansion, competitive

See CLI Setup for full setup instructions.