CLI Flags

CLI Flags

Usage

/forge [flags] <task description or URL>

Flags

--effort=<S|M|L>

Force an effort level, which determines the flow template:

Effort	Template	Skipped Phases
S	light	Task review (4b), Checkpoint B, Comprehensive Review (7)
M	standard	Task review (4b), Checkpoint B
L	full	None — all checkpoints mandatory

Default: M. XS is not supported.

--auto

Skip human checkpoints when the AI reviewer verdict is APPROVE or APPROVE_WITH_NOTES (with no CRITICAL findings). REVISE verdicts still pause for human input.

Ignored for effort L — human approval is always required.

--nopr

Skip PR creation. Changes are committed and pushed to the feature branch, but no pull request is opened.

--debug

Append a ## Debug Report section to summary.md with execution flow diagnostics:

• Token outliers
• Retry counts
• Revision cycles
• Missing phase-log entries

Note: ## Improvement Report is always appended regardless of this flag.

--discuss

Trigger a pre-pipeline clarification dialogue for plain-text input. Before the pipeline starts, the orchestrator asks up to five clarifying questions and collects your answers. The answers are then passed into pipeline_init_with_context to produce a richer task description.

Only applies to plain-text input — ignored for GitHub Issue and Jira URLs. When combined with --auto, discussion mode is suppressed.

Resume (auto-detected)

To resume an interrupted pipeline, supply the spec directory name as input. If the directory exists under .specs/, it is automatically detected as a resume:

/forge 20260320-fix-auth-timeout

No special flag is needed. The orchestrator proceeds directly without confirmation.

Backward compatibility: --resume is silently stripped from input if present, but has no effect — resume is always auto-detected from directory existence.

Examples

# Small task, auto-approve checkpoints
/forge --effort=S --auto Fix the null pointer crash in auth middleware

# Medium task, no PR
/forge --nopr Add retry logic to the API client

# Large task with debug output
/forge --effort=L --debug Add a new validation layer

# Plain-text input with pre-pipeline clarification dialogue
/forge --discuss Add caching to the search endpoint

# From GitHub Issue
/forge https://github.com/org/repo/issues/123

# From Jira
/forge https://myorg.atlassian.net/browse/PROJ-456

# Resume interrupted pipeline (auto-detected from .specs/ directory)
/forge 20260320-fix-auth-timeout