CLI Commands
LumenFlow provides a curated public CLI surface for everyday workflows.
Each command below links to its own detail page with the full description, example, guidance and options.
Commands Overview
Section titled “Commands Overview”Gates & Quality
Section titled “Gates & Quality”cert:verify
Section titled “cert:verify”Verify an agent promotion-ladder transition against certification evidence
eval:run
Section titled “eval:run”Run a certification scenario suite against an agent evaluation report
eval:suite
Section titled “eval:suite”Define, list, and validate agent certification scenario suites
events:validate
Section titled “events:validate”Validate event payloads against the published schema catalog
gate:co-change
Section titled “gate:co-change”Manage co-change gate rules (add, remove, edit, list)
gate:conditional
Section titled “gate:conditional”Manage conditional_commands gate entries (add, remove, edit, list)
Run all quality gates
lane:create
Section titled “lane:create”Create a new lane definition
lane:edit
Section titled “lane:edit”Edit a lane definition (rename, wip-limit, paths, description)
lane:health
Section titled “lane:health”Check lane config health
lane:list
Section titled “lane:list”List lane definitions (table or —json)
lane:lock
Section titled “lane:lock”Lock lane lifecycle for delivery WUs
lane:remove
Section titled “lane:remove”Remove a lane definition when no active WUs still reference it
lane:setup
Section titled “lane:setup”Create/update draft lane artifacts
lane:status
Section titled “lane:status”Show lane lifecycle status and next step
lane:suggest
Section titled “lane:suggest”Suggest workspace lane definitions from project context
lane:validate
Section titled “lane:validate”Validate lane artifacts before lock
lumenflow:pre-commit-check
Section titled “lumenflow:pre-commit-check”Run enforcement checks used by pre-commit and CI
test:baseline:init
Section titled “test:baseline:init”Create .lumenflow/test-baseline.json from current failing tests
test:baseline:update
Section titled “test:baseline:update”Refresh .lumenflow/test-baseline.json from current failing tests
validate
Section titled “validate”Run validation checks
Initiatives
Section titled “Initiatives”initiative:add-wu
Section titled “initiative:add-wu”Add WU to initiative
initiative:bulk-assign
Section titled “initiative:bulk-assign”Bulk assign WUs to initiative
initiative:create
Section titled “initiative:create”Create new initiative
initiative:delete
Section titled “initiative:delete”Delete an initiative with explicit linked-WU safeguards
initiative:edit
Section titled “initiative:edit”Edit initiative fields and phase metadata
initiative:list
Section titled “initiative:list”List all initiatives
initiative:plan
Section titled “initiative:plan”Link plan to initiative
initiative:remove-wu
Section titled “initiative:remove-wu”Remove WU from initiative
initiative:rename
Section titled “initiative:rename”Rename an initiative and rewrite linked references
initiative:status
Section titled “initiative:status”Show detailed initiative view with phases, WUs, and phase-exit evidence
Memory & Sessions
Section titled “Memory & Sessions”mem:checkpoint
Section titled “mem:checkpoint”Save progress checkpoint
mem:cleanup
Section titled “mem:cleanup”Clean up stale memory data
mem:context
Section titled “mem:context”Get context for current lane/WU
mem:converged
Section titled “mem:converged”Evaluate whether an A2A signal thread has converged
mem:create
Section titled “mem:create”Create memory node (bug discovery)
mem:delete
Section titled “mem:delete”Delete/archive a memory node
mem:export
Section titled “mem:export”Export memory as markdown
mem:inbox
Section titled “mem:inbox”Check coordination signals
mem:init
Section titled “mem:init”Initialize memory for WU
mem:ready
Section titled “mem:ready”Check pending memory nodes
mem:recover
Section titled “mem:recover”Generate recovery context after compaction
mem:roster
Section titled “mem:roster”List live agent sessions and role axes
mem:signal
Section titled “mem:signal”Broadcast coordination signal
mem:start
Section titled “mem:start”Start a memory session
mem:summarize
Section titled “mem:summarize”Summarize memory context
mem:triage
Section titled “mem:triage”Triage discovered bugs
mem:watch
Section titled “mem:watch”Deliver A2A signal events for clients without native hooks
signal:cleanup
Section titled “signal:cleanup”Clean up stale signals
Metrics & Flow
Section titled “Metrics & Flow”cost:summary
Section titled “cost:summary”Summarize local cost telemetry or brief metrics with —brief
flow:bottlenecks
Section titled “flow:bottlenecks”Identify flow bottlenecks
flow:report
Section titled “flow:report”Generate flow metrics report
metrics
Section titled “metrics”View workflow metrics
metrics:snapshot
Section titled “metrics:snapshot”Capture metrics snapshot with dispatchability and throughput
Orchestration
Section titled “Orchestration”agent:issues-query
Section titled “agent:issues-query”Query GitHub issues for agent work
agent:log-issue
Section titled “agent:log-issue”Log issue during agent session
agent:resolve
Section titled “agent:resolve”Show effective agent model-routing diagnostics
agent:session
Section titled “agent:session”Start agent session
agent:session-end
Section titled “agent:session-end”End agent session
delegation:list
Section titled “delegation:list”List delegation and launch records with planned-versus-launched state
orchestrate:init-status
Section titled “orchestrate:init-status”Show initiative progress status with phase-exit evidence and blockers
orchestrate:initiative
Section titled “orchestrate:initiative”Plan initiative execution and prepare structured handoff artifacts without claiming host launch; stored handoffs can be replayed inline
orchestrate:monitor
Section titled “orchestrate:monitor”Monitor orchestration progress, stalls, returned workers, and recovery signals
orchestrate:pre-phase-audit
Section titled “orchestrate:pre-phase-audit”Print a read-only pre-phase audit checklist before creating phase WUs
task:claim
Section titled “task:claim”Claim a task directly through KernelRuntime
pack:author
Section titled “pack:author”Author a secure domain pack from templates
pack:hash
Section titled “pack:hash”Compute integrity hash for a domain pack
pack:install
Section titled “pack:install”Install a domain pack into workspace
pack:publish
Section titled “pack:publish”Publish a domain pack to a registry
pack:scaffold
Section titled “pack:scaffold”Scaffold a new domain pack
pack:search
Section titled “pack:search”Search for domain packs in a registry
pack:validate
Section titled “pack:validate”Validate a domain pack for integrity
plan:create
Section titled “plan:create”Create a new plan
plan:edit
Section titled “plan:edit”Edit plan content
plan:link
Section titled “plan:link”Link plan to WU or initiative
plan:promote
Section titled “plan:promote”Promote plan to WU
Setup & Development
Section titled “Setup & Development”backlog:prune
Section titled “backlog:prune”Clean stale backlog entries
cloud:connect
Section titled “cloud:connect”Connect workspace.yaml to cloud control plane
compute:connect
Section titled “compute:connect”Enrol the runner with the cloud control-plane (experimental developer substrate)
compute:doctor
Section titled “compute:doctor”Self-check the Connected Compute runner (experimental developer substrate)
compute:run
Section titled “compute:run”Run the governed Connected Compute polling loop (experimental)
config:get
Section titled “config:get”Read and display a value from workspace.yaml software_delivery
config:set
Section titled “config:set”Safely update workspace.yaml software_delivery via micro-worktree
config:unset
Section titled “config:unset”Safely delete a key from workspace.yaml via micro-worktree
db:journal-recover
Section titled “db:journal-recover”Detect drizzle journal collisions and offer a safe-resequence path (dry-run by default; —confirm applies)
file:delete
Section titled “file:delete”Delete file with audit trail
file:edit
Section titled “file:edit”Edit file with audit trail
file:read
Section titled “file:read”Read file with audit trail
file:write
Section titled “file:write”Write file with audit trail
git:branch
Section titled “git:branch”Show git branch with audit trail
git:diff
Section titled “git:diff”Show git diff with audit trail
git:log
Section titled “git:log”Show git log with audit trail
git:status
Section titled “git:status”Show git status with audit trail
git:sync-main
Section titled “git:sync-main”Fast-forward a clean local main checkout to origin/main
lumenflow
Section titled “lumenflow”Initialize LumenFlow in a project
lumenflow:commands
Section titled “lumenflow:commands”List all available CLI commands
lumenflow:disable
Section titled “lumenflow:disable”Atomically disable lifecycle enforcement and remove marker-owned delegators
lumenflow:docs-sync
Section titled “lumenflow:docs-sync”Refresh LumenFlow-owned docs, onboarding docs, and canonical skills
lumenflow:doctor
Section titled “lumenflow:doctor”Diagnose LumenFlow configuration
lumenflow:enable
Section titled “lumenflow:enable”Atomically install or repair digest-bound lifecycle enforcement
lumenflow:integrate
Section titled “lumenflow:integrate”Deprecated no-op with project-owned tool-file migration guidance
lumenflow:migrate-state
Section titled “lumenflow:migrate-state”Explicit standalone Software Delivery state-namespace cutover (main checkout only; for repos that never run lumenflow:upgrade)
lumenflow:release
Section titled “lumenflow:release”Run release workflow; publishes through private Keygen licence access
lumenflow:setup-prereqs
Section titled “lumenflow:setup-prereqs”Surface external prerequisites and local runtime readiness at end of pnpm setup
lumenflow:sync-templates
Section titled “lumenflow:sync-templates”Sync templates to project
lumenflow:uninstall
Section titled “lumenflow:uninstall”Remove LumenFlow-generated files (dry-run by default; requires —confirm)
lumenflow:upgrade
Section titled “lumenflow:upgrade”Upgrade LumenFlow packages; bridges the legacy npm scope to Keygen licensing
State Management
Section titled “State Management”state:bootstrap
Section titled “state:bootstrap”Bootstrap state store
state:cleanup
Section titled “state:cleanup”Clean up stale state data
state:doctor
Section titled “state:doctor”Diagnose state store issues
state:emit
Section titled “state:emit”Emit corrective event to state store
WU Lifecycle
Section titled “WU Lifecycle”approval:list
Section titled “approval:list”List control-plane approvals with optional filters
approval:request
Section titled “approval:request”Request control-plane approval for a workflow action
approval:review
Section titled “approval:review”Resolve a control-plane approval decision
wu:amend
Section titled “wu:amend”Append an audited correction to a done WU record without rewriting it
wu:block
Section titled “wu:block”Block WU with reason
wu:brief
Section titled “wu:brief”Generate the canonical full WU handoff prompt, record evidence, and optionally report prompt tokens
wu:claim
Section titled “wu:claim”Claim WU and create worktree
wu:create
Section titled “wu:create”Create new WU spec
wu:delegate
Section titled “wu:delegate”Generate the canonical delegation handoff prompt and record explicit lineage intent
wu:done
Section titled “wu:done”Complete WU (merge, stamp, cleanup) from main
wu:edit
Section titled “wu:edit”Edit WU spec fields
wu:escalate
Section titled “wu:escalate”Show or resolve WU escalation status
wu:prep
Section titled “wu:prep”Run gates in worktree, prep for wu:done
wu:recover
Section titled “wu:recover”Recover WU state, including restoring missing active worktrees
wu:release
Section titled “wu:release”Release orphaned WU (in_progress to ready)
wu:rename
Section titled “wu:rename”Rename a WU (canonical WU IDs, —replay-only supported)
wu:sandbox
Section titled “wu:sandbox”Run command through hardened WU sandbox backend
wu:status
Section titled “wu:status”Show WU status, location, valid commands
wu:unblock
Section titled “wu:unblock”Unblock WU
wu:validate
Section titled “wu:validate”Validate WU spec
wu:verify
Section titled “wu:verify”Verify WU completion (stamp, commit, clean tree)
WU Maintenance
Section titled “WU Maintenance”wu:clean-generated
Section titled “wu:clean-generated”Governed scoped rollback for LumenFlow-managed docs and generated CLI docs
wu:cleanup
Section titled “wu:cleanup”Cleanup after PR merge
wu:delete
Section titled “wu:delete”Delete WU spec and cleanup
wu:deps
Section titled “wu:deps”Show WU dependencies
wu:infer-lane
Section titled “wu:infer-lane”Infer lane from code paths/description using workspace definitions
wu:preflight
Section titled “wu:preflight”Pre-flight checks before wu:done
wu:proto
Section titled “wu:proto”Create WU prototype
wu:prune
Section titled “wu:prune”Lease-aware stale worktree cleanup and already-merged remote lane branch pruning
wu:rebase
Section titled “wu:rebase”Rebase a claimed WU onto its integration target, pausing content conflicts for governed continue or abort
wu:rebase-meta
Section titled “wu:rebase-meta”Governed metadata-rebase normalizer for parallel-WU conflict recovery
wu:repair
Section titled “wu:repair”Repair WU state issues
wu:review
Section titled “wu:review”Review a WU worktree, and inspect, configure or record its independent review
wu:unlock-lane
Section titled “wu:unlock-lane”Unlock stuck lane
Next Steps
Section titled “Next Steps”- Configuration – Configure LumenFlow
- WU Schema – Work Unit YAML structure
- Maintaining the CLI Reference – How this page and its detail pages are generated