Installation

AI Skill (recommended for AI agents)

Install the /forge skill for Claude Code, Cursor, Codex, Gemini and 40+ AI agents:

forgeplan setup-skill   # writes ~/.claude/skills/forge/SKILL.md, no network

After installation, use in chat:

/forge "Add OAuth2 authentication"

Alternative: if you already have the CLI installed, use the built-in command instead — it embeds the skill file directly, no network required:

forgeplan setup-skill

See forgeplan setup-skill for details.

Discover more plugins: Marketplace Overview.

Full Harness Bundle (Claude Code)

The /forge skill above is enough to start. For the complete Forgeplan harness — /smith master orchestrator, /forge-cycle reactive enforcer, /audit, /sprint, /methodology-check, /forgeplan-cookbook, guardian + Profile A/B/C/D canonical agents, FPF ADI reasoning, Hindsight cross-session memory — install the recommended plugin set. This is what /smith-bootstrap Step 0a expects on a greenfield project.

Run these inside a Claude Code session:

# One-time: add the marketplace
/plugin marketplace add ForgePlan/marketplace

# 5 MUST plugins — full pipeline depends on all five
/plugin install fpl-skills@ForgePlan-marketplace          # 34 skills: smith, forge-cycle, forgeplan-cookbook, audit, sprint, methodology-check, ...
/plugin install agents-pro@ForgePlan-marketplace          # 28 agents: smith, guardian, brief-intake, adr-architect, research-analyst, ...
/plugin install agents-sparc@ForgePlan-marketplace        # 5 SPARC phase agents — first PRD is dispatched to specification
/plugin install agents-core@ForgePlan-marketplace         # 11 baseline agents: coder, code-reviewer, tester
/plugin install forgeplan-workflow@ForgePlan-marketplace  # /forge-cycle + /forge-audit + guardian gate enforcement

# 2 SHOULD plugins — strongly recommended
/plugin install fpf@ForgePlan-marketplace                 # FPF ADI reasoning — mandatory for Standard+ artifacts
/plugin install fpl-hsmem@ForgePlan-marketplace           # Hindsight cross-session memory (per-project bank)

# Reload to activate
/reload-plugins

After reload, /smith-bootstrap for a fresh repo or /smith for next-action recommendations are ready to use.

What each plugin gives you

Plugin	What you can do with it
`fpl-skills`	Type `/smith` and it figures out what kind of task you have and which methodology fits. Drives the day-to-day commands: `/forge-cycle` to walk a task to completion, `/audit` for multi-expert code review, `/sprint` for wave-based execution, `/forgeplan-cookbook` to look up the right forgeplan tool. The skills brain of the system.
`agents-pro`	Dispatch named specialists when you need them: `brief-intake` turns a vague idea into a structured Brief, `adr-architect` produces architecture decisions with three considered alternatives, `research-analyst` gathers prior art before you commit to a direction, `guardian` runs the last check before activation.
`agents-sparc`	Use the SPARC five-phase flow for any new feature: Specification → Pseudocode → Architecture → Refinement → Completion. Without it, the first PRD on a fresh project lands without the SPARC structure and you have to redo the spec phase by hand.
`agents-core`	Actually write, review, and test code. The `coder` agent edits files in an isolated worktree, `code-reviewer` produces structured findings against the spec, `tester` runs the suite and reports coverage delta.
`forgeplan-workflow`	Run the `/forge-cycle` command — the reactive enforcer that walks an artifact through validate → ADI → review → activate one step at a time. Plus `/forge-audit` for multi-expert code audit and the guardian gate enforcement that decides whether a PRD is ready to ship.

Optional plugins

Plugin	When to add
`laws-of-ux`	Frontend / UX code review with 30 Laws of UX
`agents-domain`	Domain-specific agents: TypeScript, Go, Python, Next.js, React, Rust, etc.
`agents-github`	GitHub workflow agents: PR, issues, releases, projects, workflows
`forgeplan-brownfield-pack`	Onboarding existing codebases via the 7-phase Discover protocol
`forgeplan-orchestra`	Sync with Orchestra task management

See Marketplace Overview for the full plugin catalog.

CLI Binary

macOS (Homebrew)

brew install forgeplan/tap/forgeplan

From source (Rust)

cargo install forgeplan

GitHub Releases

Download pre-built binaries from GitHub Releases.

MCP Server (for AI agents)

Add to your project’s .mcp.json:

{
  "mcpServers": {
    "forgeplan": {
      "command": "forgeplan",
      "args": ["serve"],
      "env": {}
    }
  }
}

Initialize Workspace

forgeplan init -y

This creates .forgeplan/ directory with config and LanceDB storage.

Verify Installation

forgeplan --version
forgeplan health