eforge CLI Reference

Autonomous plan-build-review CLI for code generation.

Usage: eforge [command] [options]

Commands

enqueue

Full command: eforge enqueue

Normalize input and add it to the PRD queue

Options:

Flag	Description
--name <name>	Override the inferred PRD title
--verbose	Stream agent output
--no-plugins	Disable plugin loading
--profile <name>	Override active profile for this enqueue + build
--landing-action <action>	Landing action for this build (pr|merge|leave)
--landing-auto-merge	Enable PR auto-merge for this build
--no-landing-auto-merge	Disable PR auto-merge for this build
--after <queue-id>	Explicit upstream dependency: waits in waiting/ if the upstream is active; enqueues immediately as an eligible dependent if the upstream completed with a usable artifact
--post-merge <command>	Per-enqueue post-merge validation command (repeatable)

build

Full command: eforge build

Compile + build + validate in one step

Alias: run

Options:

Flag	Description
--auto	Run without approval gates
--verbose	Stream agent output
--name <name>	Plan set name (inferred from source if omitted)
--queue	Process all PRDs from the queue
--max-concurrent-builds <n>	Max parallel queue PRDs
--dry-run	Compile only, then show execution plan without building
--foreground	Run in-process instead of delegating to daemon
--no-cleanup	Keep plan files after successful build
--no-monitor	Disable web monitor
--no-plugins	Disable plugin loading
--watch	Watch mode: continuously poll the queue for new PRDs
--poll-interval <ms>	Poll interval in milliseconds for watch mode
--profile <name>	Override active profile for this build
--landing-action <action>	Landing action for this build (pr|merge|leave)
--landing-auto-merge	Enable PR auto-merge for this build
--no-landing-auto-merge	Disable PR auto-merge for this build
--after <queue-id>	Explicit upstream dependency: waits in waiting/ if the upstream is active; enqueues immediately as an eligible dependent if the upstream completed with a usable artifact

monitor

Full command: eforge monitor

Start or connect to the monitor dashboard

Options:

Flag	Description
--port <port>	Preferred port

status

Full command: eforge status

Check running builds

queue

Full command: eforge queue

Manage PRD queue

priority

Full command: eforge queue priority

Update the priority for a pending or waiting PRD queue item

remove

Full command: eforge queue remove

Remove a non-running PRD queue item

list

Full command: eforge queue list

Show PRDs in the queue

run

Full command: eforge queue run

Process PRDs from the queue

Options:

Flag	Description
--all	Process all pending PRDs
--auto	Run without approval gates
--verbose	Stream agent output
--no-monitor	Disable web monitor
--no-plugins	Disable plugin loading
--max-concurrent-builds <n>	Max parallel queue PRDs
--watch	Watch mode: continuously poll the queue for new PRDs
--poll-interval <ms>	Poll interval in milliseconds for watch mode
--landing-action <action>	Landing action for this build (pr|merge|leave)
--landing-auto-merge	Enable PR auto-merge for this build
--no-landing-auto-merge	Disable PR auto-merge for this build

exec

Full command: eforge queue exec

Build a single PRD directly (subprocess entry point for the queue scheduler)

Options:

Flag	Description
--auto	Run without approval gates
--verbose	Stream agent output
--no-monitor	Disable web monitor
--no-plugins	Disable plugin loading
--session-id <uuid>	Session ID injected by parent scheduler (skips child session:start emission)
--profile <name>	Override active profile for this build
--landing-action <action>	Landing action for this build (pr|merge|leave)
--landing-auto-merge <bool>	Enable PR auto-merge for this build (true|false)

extension

Full command: eforge extension

Manage native eforge extensions

list

Full command: eforge extension list

List discovered native extensions

Options:

Flag	Description
--json	Output JSON

show

Full command: eforge extension show

Show one native extension by name

Options:

Flag	Description
--json	Output JSON

validate

Full command: eforge extension validate

Validate configured native extensions, or a single extension name/path

Options:

Flag	Description
--json	Output JSON

test

Full command: eforge extension test

Dry-run native extension event hooks against fixture or monitor events

Options:

Flag	Description
--run <run>	Replay monitor DB events: latest or a session/run id
--event <type>	Filter replay input by exact event type
--fixture <path>	Replay project-local fixture events from a JSON or JSONL file
--json	Output JSON

new

Full command: eforge extension new

Scaffold a native eforge extension

Options:

Flag	Description
--scope <scope>	Extension scope: local, project, or user
--template <template>	Scaffold template
--force	Overwrite an existing extension file
--json	Output JSON

reload

Full command: eforge extension reload

Reload native extension discovery and restart the daemon watcher when running

Options:

Flag	Description
--json	Output JSON

trust

Full command: eforge extension trust

Trust a project-team native extension by name or path

Options:

Flag	Description
--trusted-by <identity>	Optional annotation identifying who is trusting the extension
--json	Output JSON

untrust

Full command: eforge extension untrust

Remove trust for a project-team native extension by name or path

Options:

Flag	Description
--json	Output JSON

install

Full command: eforge extension install

Install a native extension package from an npm package, local path, or tarball

Options:

Flag	Description
--scope <scope>	Extension scope: local, project, or user
--name <name>	Logical extension name override
--force	Overwrite an existing extension at the target scope
--trust	Trust the extension after install (project-team scope only)
--trusted-by <identity>	Optional annotation identifying who is trusting the extension
--json	Output JSON

update

Full command: eforge extension update

Update an installed extension package to the latest version

Options:

Flag	Description
--version <specifier>	Version specifier or dist-tag for npm-installed extensions
--trust	Trust the extension after update (project-team scope only)
--trusted-by <identity>	Optional annotation identifying who is trusting the extension
--json	Output JSON

remove

Full command: eforge extension remove

Remove an installed extension package

Options:

Flag	Description
--force	Remove without confirmation
--json	Output JSON

promote

Full command: eforge extension promote

Promote a project-local extension to project-team scope

Options:

Flag	Description
--force	Overwrite an existing extension at project-team scope
--trust	Trust the extension after promotion
--trusted-by <identity>	Optional annotation identifying who is trusting the extension
--json	Output JSON

demote

Full command: eforge extension demote

Demote a project-team extension to project-local scope

Options:

Flag	Description
--force	Overwrite an existing extension at project-local scope
--json	Output JSON

contributions

Full command: eforge extension contributions

Discover and invoke extension-provided host contributions

list

Full command: eforge extension contributions list

List extension-provided actions, integration commands, and deep links

Options:

Flag	Description
--kind <kind>	Contribution kind: action, command, deep-link, or all
--extension-name <name>	Filter to one extension name
--search <text>	Search id, label, description, extension, and action metadata
--id-prefix <prefix>	Filter to contribution ids with this prefix
--output-profile <profile>	Filter by action output profile
--limit <number>	Maximum entries to return
--offset <number>	Zero-based pagination offset
--include-schema	Include input schemas/defaults in the list projection
--include-diagnostics	Include manifest diagnostics in the list projection
--full	Use the full projection, including schemas and diagnostics
--json	Output JSON

show

Full command: eforge extension contributions show

Show one extension action, integration command, or deep link contribution

Options:

Flag	Description
--kind <kind>	Contribution kind: action, command, or deep-link
--include-schema	Include input schema/defaults in the detail projection
--include-diagnostics	Include manifest diagnostics in the detail projection
--full	Use the full projection, including schema and diagnostics
--json	Output JSON

invoke

Full command: eforge extension contributions invoke

Invoke an extension action, integration command, or action-backed deep link

Options:

Flag	Description
--kind <kind>	Contribution kind: action, command, or deep-link
--input-json <json>	JSON object input for the action
--input-file <path>	Path to a JSON object input file
--json	Output JSON

config

Full command: eforge config

Manage eforge configuration

validate

Full command: eforge config validate

Validate eforge/config.yaml configuration

show

Full command: eforge config show

Show resolved eforge configuration

daemon

Full command: eforge daemon

Manage persistent daemon server

start

Full command: eforge daemon start

Start the persistent daemon server

Options:

Flag	Description
--port <port>	Preferred port

stop

Full command: eforge daemon stop

Stop the persistent daemon server

Options:

Flag	Description
--force	Skip active-build safety check

restart

Full command: eforge daemon restart

Restart the persistent daemon server

Options:

Flag	Description
--force	Skip active-build safety check

status

Full command: eforge daemon status

Show daemon status

kill

Full command: eforge daemon kill

Force-kill the daemon (SIGKILL)

ignite

Full command: eforge ignite

Playful alias for eforge daemon start

Options:

Flag	Description
--port <port>	Preferred port

douse

Full command: eforge douse

Playful alias for eforge daemon stop

Options:

Flag	Description
--force	Skip active-build safety check

reignite

Full command: eforge reignite

Playful alias for eforge daemon restart

Options:

Flag	Description
--force	Skip active-build safety check

recover

Full command: eforge recover

Analyse a failed build and write recovery sidecar files

Options:

Flag	Description
--cwd <cwd>	Working directory override
--verbose	Stream agent output
--no-monitor	Disable web monitor

apply-recovery

Full command: eforge apply-recovery

Apply the recovery verdict for a failed build plan (retry from scratch, continue-and-repair, abandon, or manual)

Options:

Flag	Description
--cwd <cwd>	Working directory override
--no-monitor	Disable web monitor

continue-repair

Full command: eforge continue-repair

Continue and repair build from preserved compiled artifacts

Options:

Flag	Description
--set-name <setName>	Override the set name; when omitted, resolved from recovery sidecar or derived from the prdId
--profile <name>	Override active profile for this continue-and-repair build
--cwd <cwd>	Working directory override
--verbose	Print additional queued metadata

mcp-proxy

Full command: eforge mcp-proxy

Run the MCP stdio proxy server (used by Claude Code plugin)

stack

Full command: eforge stack

Stack management commands

sync

Full command: eforge stack sync

Sync the git-spice stack with remote and restack eligible branches

Options:

Flag	Description
--dry-run	Show what commands would run without executing them
--cwd <cwd>	Working directory override

Global options

Options:

Flag	Description
-V, --version	output the version number