CLI Reference

Forgeplan ships with 61 top-level commands covering the full Shape→Validate→ADI→Code→Evidence→Activate lifecycle.

All commands are listed below grouped by purpose. Click any command for full usage, arguments and examples.

Workspace & setup

Command	Description
`forgeplan init`	Initialize a new .forgeplan/ workspace
`forgeplan setup-skill`	Install /forge skill for Claude Code
`forgeplan migrate`	Run schema migrations on existing workspace
`forgeplan import`	Import artifacts from JSON file
`forgeplan export`	Export all artifacts to JSON file

Creating artifacts

Command	Description
`forgeplan new`	Create a new artifact from template
`forgeplan generate`	Generate an artifact using AI from a natural language description
`forgeplan capture`	Capture a decision from conversation into a Note or ADR artifact
`forgeplan promote`	Promote a memory to a full artifact (e.g., forgeplan promote mem-xxx —kind prd)

Reading artifacts

Command	Description
`forgeplan list`	List artifacts
`forgeplan get`	Read a full artifact by ID
`forgeplan tree`	Show artifact hierarchy as ASCII tree
`forgeplan search`	Search artifacts (smart by default: keyword + semantic + boosters)
`forgeplan recall`	Recall memories — search, filter, list
`forgeplan log`	Show change log — audit trail of artifact mutations
`forgeplan journal`	Show decision journal — chronological timeline with R_eff scores
`forgeplan session`	Show methodology session state (current phase, active artifact)
`forgeplan progress`	Show checkbox progress for artifacts
`forgeplan graph`	Generate mermaid dependency graph of linked artifacts
`forgeplan order`	Show artifacts in topological order (dependency order)

Editing artifacts

Command	Description
`forgeplan update`	Update artifact metadata or body
`forgeplan delete`	Delete an artifact
`forgeplan tag`	Add tags to an artifact
`forgeplan untag`	Remove tags from an artifact
`forgeplan link`	Link two artifacts with a typed relationship
`forgeplan unlink`	Remove a relation between two artifacts

Quality & validation

Command	Description
`forgeplan validate`	Validate artifact completeness against schema rules
`forgeplan score`	Compute R_eff quality score for decisions with evidence
`forgeplan fgr`	Show F-G-R quality scores (Formality, Granularity, Reliability)
`forgeplan review`	Review an artifact — run validation and show lifecycle checklist
`forgeplan estimate`	Estimate effort for an artifact based on FR and Phase items
`forgeplan calibrate`	Suggest depth level (Tactical/Standard/Deep/Critical) based on artifact content
`forgeplan calibrate-estimate`	Compare estimated vs actual hours — calibrate estimation accuracy
`forgeplan decay`	Show evidence decay impact on R_eff scores
`forgeplan stale`	Detect stale artifacts with expired valid_until

Lifecycle transitions

Command	Description
`forgeplan activate`	Activate an artifact (draft → active) with validation gate
`forgeplan supersede`	Supersede an artifact (active → superseded) with replacement link
`forgeplan deprecate`	Deprecate an artifact (active/stale → deprecated) with reason
`forgeplan renew`	Renew a stale artifact (stale → active) with extended validity
`forgeplan reopen`	Reopen an artifact — creates a NEW draft artifact, deprecates the old one

Reasoning & AI

Command	Description
`forgeplan reason`	Analyze an artifact using FPF ADI reasoning cycle (Abduction→Deduction→Induction)
`forgeplan decompose`	Decompose a PRD into RFC tasks using AI
`forgeplan context`	Single-call reasoning context — artifact + graph + validation + scoring
`forgeplan route`	Suggest depth level and artifact pipeline for a task description

Dashboards & health

Command	Description
`forgeplan health`	Show project health dashboard — gaps, risks, blind spots, next actions
`forgeplan status`	Show project status dashboard
`forgeplan gaps`	Show pipeline compliance gaps by depth
`forgeplan blocked`	Show blocked artifacts and their dependencies
`forgeplan blindspots`	Show blind spots — decisions without evidence, orphan artifacts
`forgeplan drift`	Check for drifted decisions (affected files changed after decision)
`forgeplan coverage`	Show decision coverage per code module

Indexing & sync

Command	Description
`forgeplan scan`	Scan codebase for source modules
`forgeplan scan-import`	Scan for existing docs and import as artifacts
`forgeplan reindex`	Rebuild LanceDB index from .md files (files-first sync)
`forgeplan embed`	Generate embeddings for all artifacts (semantic search)
`forgeplan watch`	Watch .forgeplan/ files and sync changes to LanceDB in real time
`forgeplan git-sync`	Sync artifact changes from git operations (pull/merge) into LanceDB

Memory

Command	Description
`forgeplan remember`	Save a memory (fact, convention, procedure) for later recall
`forgeplan discover`	Start brownfield discovery — creates session, prints protocol for agent

FPF knowledge base

Command	Description
`forgeplan fpf`	FPF Knowledge Base — dashboard, ingest, search, sections

MCP server

Command	Description
`forgeplan serve`	Start MCP server (stdio transport) for AI agent integration

Ecosystem & Plugins

Beyond the built-in CLI, Forgeplan integrates with AI coding agents via the /forge skill and related marketplace plugins:

Forgeplan Workflow — /forge, /forge-cycle, /forge-audit slash commands
Dev Toolkit — /sprint, /audit, /recall, /research, /build
Marketplace Overview — full plugin catalog

Install the core skill with forgeplan setup-skill or npx skills add ForgePlan/marketplace --skill forge. Additional plugins are available via npx skills add ForgePlan/marketplace --plugin <name>.