Unified API Surface Index

One index, four surfaces. Every 104 MCP tool, every 97 CLI command, every REST endpoint domain, and every SDK export, alphabetized, grouped, and cross-linked. If you can't remember whether forge_secret_scan has a CLI wrapper, this is the page.

On this page

• The four surfaces
• MCP tools (104, grouped by domain)
• CLI commands (57, grouped by use)
• REST endpoints (103, grouped by prefix)
• SDK exports (11 sub-paths)
• Surface coverage matrix

The four surfaces

Plan Forge exposes its capabilities through four orthogonal transports. The same handler set backs all four, choosing one is a question of who is calling.

WebSocket events on /api/hub are the fifth, observation-only surface, see Chapter 29 — Integrating from Outside. The full payload schema for every hub event is in Appendix V — Event Catalog.

MCP tools — by domain

Canonical source: pforge-mcp/tools.json. The full description, input schema, error map, and example for each tool is exposed via forge_capabilities. The table below is the one-line index.

Diagnostics & setup (7)

GitHub stack (3)

Team coordination (2)

Plan execution (8)

Cost & quorum (5)

Crucible — idea smelting (8)

Tempering — coverage & quality (5)

Triage, bugs & classifiers (6)

Memory, provenance & brain (9)

Copilot integration (1)

Lattice — code graph (5)

Knowledge graph & patterns (2)

Anvil — memoization cache (5)

Semantic recall & embeddings (3)

Health, trends & hotspots (4)

Incidents, deploys & dependencies (3)

LiveGuard — deploy safety (4)

Fix & runbook (3)

Skills & org rules (3)

Cross-project watching (2)

Review queue (3)

Delegation & notifications (3)

Search, timeline & snapshots (4)

Testbed (3)

Extensions, Forge-Master, image gen, meta (5)

CLI commands — pforge

Canonical source: pforge.ps1 + pforge.sh (mirror implementations). Schema doc: pforge-mcp/cli-schema.json. The full reference with arguments, flags, and examples lives in Chapter 8 — CLI Reference; this is the one-line index.

Core (12)

pforge smith                    Diagnose environment + setup health
pforge check                    Validate setup files
pforge validate                 (alias) Validate Plan Forge setup
pforge status                   Show phase status from roadmap
pforge sweep                    Scan for TODO/FIXME markers
pforge tour                     Guided walkthrough of installed Plan Forge files
pforge help                     Show help
pforge config get/set <k> [v]   Read or write keys in .forge.json (atomic)
pforge update                   Update framework files (auto-selects source)
pforge self-update              Force-pull latest GitHub release
pforge install                  First-time install bootstrap
pforge init                     Initialize a new project

Plan + analysis (12)

pforge new-phase <name>         Create a new phase plan + roadmap entry
pforge analyze                  Cross-artifact consistency scoring (0-100)
pforge run-plan <plan>          Execute a hardened plan
pforge diff <plan>              Compare changes against plan Scope Contract
pforge phase-status             Update phase status in DEPLOYMENT-ROADMAP
pforge regression-guard <plan>  Run validation gates from plan files
pforge plan-from-sarif <sarif>  Generate a fix plan from a SARIF findings file
pforge fix-proposal <finding>   Generate a 1-3 slice fix plan
pforge runbook <plan>           Generate operational runbook from a plan
pforge branch <plan>            Create git branch from plan's Branch Strategy
pforge commit                   Auto-generate conventional commit from slice goal
pforge version-bump [v]         Update VERSION + package.json + badges

Team + Copilot (8)

pforge team-dashboard           Per-developer cards in the terminal
pforge team-activity            Query the team-activity.jsonl ledger
pforge sync-memories            Generate .github/copilot-memory-hints.md
pforge sync-instructions        Generate .github/copilot-instructions.md
pforge sync-spaces              Sync inter-project memory spaces
pforge github status            Inspect GitHub-native AI surface
pforge github metrics           Live repo metrics via gh CLI
pforge org-rules                Export org-level custom instructions

Quality, drift & health (10)

pforge drift                    Score codebase against architecture guardrails
pforge hotspot                  Identify git churn hotspots
pforge health-trend             Drift, cost, incidents, model perf over time
pforge digest                   Daily digest, yesterday's deltas + anomalies
pforge triage                   Triage open alerts by priority
pforge dep-watch                Dependency vulnerability + freshness
pforge incident capture         Record an incident
pforge deploy-log               Record a deployment
pforge audit-loop               Drive a single audit-loop iteration
pforge audit list/show          Inspect classifier audit findings

Tempering (4)

pforge hammer-fm                Run the full tempering harness (false-marker scan)
pforge testbed-happypath        Run all happy-path testbed scenarios
pforge regression-guard         (also a plan command) Run gates as guard
pforge mcp-call <tool> ...      Invoke any MCP tool not yet wrapped by a verb

Memory + brain (6)

pforge drain-memory             Drain OpenBrain queue via local MCP REST
pforge migrate-memory           Merge legacy *-history.json into .jsonl
pforge fm-session               Start a Forge-Master reasoning session
pforge fm-recall                Recall a prior Forge-Master session
pforge anvil stat/purge         Inspect / reset the Δ-only memoization layer
pforge lattice index/stat/...   Code-graph index commands

Security & environment (5)

pforge secret-scan              Scan recent commits for high-entropy strings
pforge env-diff                 Compare .env keys across environments
pforge quorum-analyze           Assemble quorum prompt from LiveGuard data
pforge hallmark verify          Verify Hallmark provenance envelopes
pforge ext add/remove/...       Extension management

Total: 57+ top-level CLI commands across 7 functional areas. Run pforge --help for the live listing on your installed version.

REST endpoints — /api/*

Canonical source: handlers in pforge-mcp/server.mjs + pforge-mcp/dashboard/. Full per-endpoint reference: Appendix W — REST API Reference; raw dump in docs/REST-API.md on GitHub. OpenAPI spec: GET /api/openapi.json.

116 endpoints organize into these prefixes (one-line summary each, see Appendix W for verbs, query params, request/response shapes, and error codes):

SDK — pforge-sdk

Twelve sub-paths, all pure Node.js (zero runtime dependencies). Full reference: pforge-sdk/README.md on GitHub.

Surface coverage matrix

Not every capability is exposed through every surface. This matrix shows which features have CLI wrappers, REST endpoints, and SDK helpers. Use it to pick the right surface for a caller.