Turn your AI terminal assistant into a PM agent.
Claude Code, Gemini CLI, and Codex CLI are the terminal interfaces for Claude (Anthropic), Gemini (Google), and Codex (OpenAI) — AI assistants you run from your computer's command line instead of a browser chat. headless-pm installs 101 PM skills into whichever one you use, so it stops being a generic chatbot and starts behaving like a product manager.
npx headless-pm installAuto-detects which AI assistant you have. Installs skills into each one. Prompts to connect your tools.
New to the terminal? → Getting Started Guide — step-by-step from zero to your first /pm-onboarding run.
Free — everything below installs with npx headless-pm install:
- 101 PM skills across 16 categories: discovery, JTBD, roadmapping, OKR, sprint, GTM, competitive, metrics, stakeholder comms, and more
/pm-onboarding— wizard that sets up your.pm/STATE.mdworkspace in 8 questions- 8 PM domain subagents —
/discovery,/customer-research,/strategy,/market-research,/execution,/gtm,/analytics,/stakeholder. Plus/pm-agentshub to find the right one. Each routes to domain skills or runs a full auto-sequence. - Deep methodology knowledge — 7 Powers, JTBD, April Dunford positioning, Shape Up, Lean Startup, and 50+ PM frameworks built in
- Cross-linked workflows — every skill points to the next one.
/pm-hypothesis→/brainstorm-experiments→/pm-ab. No dead ends - Connects to your tools — Notion, Linear, Jira, Miro, Exa, Google Sheets, Figma, Slack, GitHub via MCP
- Works with Claude Code, Gemini CLI, and Codex CLI — all three, or just one
Paid — /pm orchestrator:
- Reads your
.pm/STATE.mdand routes to the right skill automatically. No manual selection — just/pmand it thinks for you
npx headless-pm installThen open Claude Code (or Gemini CLI / Codex) in your project directory and run the onboarding wizard:
/pm-onboarding
It asks 8 questions and creates .pm/STATE.md — your workspace context. Then use any skill directly:
/pm-sprint-plan— plan a sprint/pm-prd— write a PRD/pm-discovery— run a discovery session/cusdev— customer interview (Mom Test)/pm-roadmap— build a roadmap
You can also skip onboarding and use any skill directly — no STATE.md required.
Have the /pm orchestrator? Just type /pm — it reads your STATE.md and routes automatically. No flags, no menus.
| Category | Skills |
|---|---|
| Domain Subagents | /discovery, /customer-research, /strategy, /market-research, /execution, /gtm, /analytics, /stakeholder, /pm-agents |
| Orchestrator | /pm (paid) |
| Customer Development | /cusdev, /switch-interview, /continuous-interview-synthesis |
| Discovery & Research | /pm-discover, /pm-discovery, /pm-define, /pm-hypothesis, /pm-learn, /pm-market, /pm-cjm, /opportunity-solution-tree |
| JTBD & Segmentation | /pm-jtbd, /pm-persona, /attitudinal-segmentation, /user-segmentation, /jtbd-interview, /pm-segmentation-synthesis |
| Survey & Feedback | /pm-survey, /pm-nps-csat, /feedback-triage, /pm-cluster |
| Definition & Spec | /pm-prd, /pm-story, /pm-epic, /pm-acceptance, /pm-brief |
| Sprint & Delivery | /pm-sprint, /pm-sprint-plan, /pm-backlog, /pm-capacity, /pm-estimation, /pm-dependencies, /pm-kickoff, /pm-standup, /pm-status, /pm-demo, /pm-retro, /pm-save |
| Strategy | /strategy-stack, /vision-setting, /product-work-levels, /ansoff-matrix, /swot-analysis, /pestle-analysis, /pm-radar |
| OKR & Roadmap | /pm-okr, /pm-roadmap, /pm-portfolio, /pm-prioritize, /pm-plan |
| Market & Sizing | /tam-sizing, /market-sizing, /beachhead-mapping |
| Positioning & Messaging | /positioning-five-component, /icp-definition, /messaging-hierarchy, /pm-positioning, /competitive-battlecard |
| Competitive | /pm-competitive, /pm-competitive-synthesis |
| GTM & Launch | /pm-gtm, /pm-launch, /pm-feature-flags, /pm-release, /pm-release-lifecycle, /pm-pricing-changes |
| Stakeholder & Comms | /pm-stakeholder, /pm-exec-brief, /risk-escalation, /audience-tailoring, /weekly-digest, /influence-without-authority |
| Metrics & Analytics | /pm-metrics, /north-star-selection, /funnel-analysis, /dashboard-structuring, /pm-ab, /pm-adoption, /pm-customer-health, /pm-analyst, /growth-loops |
| Experiments & Risk | /assumption-mapping, /brainstorm-experiments, /lean-canvas, /pre-mortem, /pm-decision |
| Ops & Incidents | /pm-incident-response, /pm-postmortem, /pm-sla-slo, /pm-sunset-deprecation |
npx headless-pm install # Install skills + tools + MCP setup
npx headless-pm setup --key=YOUR-KEY # Unlock /pm orchestrator with license key
npx headless-pm mcp # Re-run MCP setup
npx headless-pm mcp --list # List available MCP servers
npx headless-pm list # List installed skills and tools
npx headless-pm update # Update to latest versionRuns automatically during install. You'll see a checkbox list — select the tools you use.
- Go to notion.so/my-integrations → New integration
- Copy the Internal Integration Token
- Share relevant pages with your integration (open page →
...→ Connections → your integration)
OAuth — no API key needed. A browser window opens on first use.
OAuth — no API key needed. A browser window opens on first use.
Write access: The OAuth flow provides read-only access. For write operations (creating cards, updating boards), generate a personal access token with
boards:writescope at miro.com/app/settings/user-profile/apps and set it asMIRO_TOKENin your environment.
AI-powered web search. After install, you will see setup instructions to add your API key.
Get your API key: exa.ai/settings/api-keys
Free — everything you need to get started:
- All 101 PM skills (slash commands)
/pm-onboardingwizard- 8 PM subagents
- MCP integrations (Notion, Linear, Jira, Miro)
Paid — /pm orchestrator
Reads your .pm/STATE.md, routes automatically, coordinates subagents. No manual skill selection — just /pm and it thinks for you.
Get a license: headlesspm.com
- All 101 PM skills now free — only
/pmorchestrator requires a license - All 35 previously-orphaned skills now listed in domain subagent routing tables
- Skill count corrected to 101 across README, npm description, and all marketing copy
- Skill Categories table now complete —
jtbd-interview,pm-segmentation-synthesis,influence-without-authorityadded - Fixed: skill cleanup on update no longer removes skills it doesn't own (manifest-based tracking)
- Fixed: subagents no longer show paywall messaging for free skills
- 8 domain subagents:
/discovery,/customer-research,/strategy,/market-research,/execution,/gtm,/analytics,/stakeholder /pm-agentshub — describe your task, get routed to the right domain- 30 previously-hidden framework skills now installed (ansoff-matrix, swot-analysis, north-star-selection, funnel-analysis, and 26 more)
- 3 new skills:
/jtbd-interview,/pm-segmentation-synthesis,/influence-without-authority
- All 88 skills now have "Related skills:" cross-links — every skill points to the next one in the workflow
- Knowledge base expanded to 59 files: added Jobs-to-be-Done (Moesta/Christensen/Ulwick) and April Dunford positioning
- 37 new skills added since v0.6.x: strategy, positioning, experiments, segmentation, comms, and more
- Zero isolated skills — every workflow chain is navigable end-to-end
updatecommand now removes skills that were deleted in newer versions — no stale/pm-*commands left behind after upgrade
- CLI notifies you when a new version is available
npx headless-pm updatenow does a full reinstall (not just a version bump)
/pmnow opens with a visual dashboard: lifecycle phase, sprint status, artifact inventory/pm-save— new skill to wrap up a PM session and commit context to git
- All major PM workflows now run as autonomous agents with Opening/Closing Dashboards
- 24 skills upgraded: discovery, competitive, release lifecycle, sprint planning, exec brief, backlog grooming, and more
- Agent Communication Protocol standardized across all agents
- Gemini CLI routing directives hardened for all agent skills
- 40-file knowledge base: 7 Powers, AARRR, Mom Test, North Star, Crossing the Chasm, Van Westendorp
- Universal Rules + Output Templates injected into all 51 skills
- Gemini MCP fix: Notion, Linear, Jira, Miro reliably registered on install
/pmreads.pm/workspace and routes to the right skill automatically