Skip to main content

CLI Command Reference

OpenExec is a single binary. Run any command with --help to see its full flags and subcommands:

openexec <command> --help

The commands below are grouped by purpose.

Setup & project

CommandDescription
openexec init [project-name]Initialize a new OpenExec project (creates .openexec/config.json and openexec.yaml).
openexec config showShow the current configuration.
openexec config set <key> <value>Set a configuration value.
openexec config initInitialize configuration with defaults.
openexec doctorCheck your environment for common issues (CLI tools, config).
openexec versionPrint the OpenExec version.
openexec updateUpdate OpenExec to the latest version.

Planning

CommandDescription
openexec wizardStart the guided intent interviewer; generates INTENT.md.
openexec plan [intent-file]Advanced: generate a project plan manually. Deprecated — use openexec run.
openexec goal verify [goal-id]Verify the implementation against defined goals.

Execution & monitoring

CommandDescription
openexec startStart the execution daemon for concurrent task processing.
openexec run [task-id]Execute tasks using the execution engine (daemon-orchestrated).
openexec blueprint <task-description>Execute a single task using blueprint-based orchestration.
openexec chatStart an interactive conversational session.
openexec status [run-id]Show execution-engine and run status (supports --watch and --json).
openexec tui [directory]Launch the interactive terminal dashboard.
openexec stopStop the execution engine.
openexec restartRestart the execution engine.

See Monitoring Status for status output details.

Knowledge & skills

CommandDescription
openexec knowledge index [directory]Index project source code into deterministic Pointer Records.
openexec knowledge show [symbols|envs|api|prd]Show records in the current project's knowledge base.
openexec knowledge ls [directory]List projects with an initialized knowledge base.
openexec knowledge init [directory]Initialize an empty knowledge base at a path.
openexec skills listList all available skills.
openexec skills info <name>Show details about a skill.
openexec skills search <query>Search skills by keyword.
openexec skills create <name>Scaffold a new user skill.
openexec skills enable <name> / disable <name>Enable or disable a skill.
openexec skills importImport skills from external sources.

Releases, stories & tasks

CommandDescription
openexec release create <version>Create a new release.
openexec release showShow current release information.
openexec release changelogGenerate a changelog for the current release.
openexec release processProcess approved stories and complete the release pipeline.
openexec release resetReset all stories and tasks to pending status.
openexec story create <id> <title> / list / show <id>Manage stories.
openexec story merge <id> / approve <id>Merge or approve a story.
openexec task create <id> <title> / complete <id> / listManage tasks.
openexec task link <id> <commit> / autolinkLink commits to tasks.

Safety, audit & patches

CommandDescription
openexec approve listList pending tool approval requests.
openexec approve yes <id> / no <id> [reason]Approve or reject a pending request.
openexec auditScan a path for stub patterns and emit a markdown/JSON report.
openexec patch apply [diff-file]Apply a unified diff scoped to the workspace root.
openexec actions validateValidate an Action JSON from stdin.
openexec replay [run-id]Inspect checkpointed artifacts for a run (patch sequence).

Integration & advanced

CommandDescription
openexec mcp-serveRun the OpenExec MCP signal server (used by Claude Code).
openexec config provider listList configured API provider endpoints (also add, use <name>, remove <name>).
openexec seedSeed a running template app with synthetic users and traffic.