agentify run

Launch a provider task with selected context.

One command, one task string, one provider. The dispatcher refreshes the index when stale, builds a planner prompt, and hands control to the provider. Flags are listed exactly as parsed in src/main.js.

flag table next: sess
dispatch src/main.js:574 positional task argv[1..] writes .agentify/runs/
flags

Every flag is parsed at the main dispatcher.

Booleans default to false unless noted. --interactive is true by default for provider templates. The positional task text is required when not interactive.

--provider

Provider name (codex, claude, gemini, opencode, local). Falls back to .agentify.yaml default.

--root

Override repo root. Defaults to current working directory.

--interactive

Run an interactive provider shell. True by default for template-based providers; pass --interactive=false to force a one-shot run.

--continue / --resume

Resume the most recent session for the active provider. Reads the latest entry under .agentify/session/.

--context-mode

Either compact or routed. Default is CONTEXT_MODE_DEFAULT from config; routed picks files via planner.

--with-context

Force-include the planner-selected file slices in the provider prompt.

--caveman[=level]

Compress prompt with caveman skill. Accepted levels: lite, full, ultra, wenyan, wenyan-lite, wenyan-full, wenyan-ultra.

--explain-plan

Print planner score breakdown before launch. Useful with --dry-run.

--skip-refresh

Skip the implicit up step. Pair with --fail-on-stale in CI.

--fail-on-stale

Exit non-zero if .agentify/index.db is older than the source tree.

--timeout

Per-launch timeout (seconds). Forwarded to the provider invocation.

--hook

Hook-friendly mode: forwards skipCodeBodyChanges through the validation step.

--dry-run / --json

Standard global flags. --dry-run reports the planned launch without invoking the provider; --json emits machine-readable output.

i/o paths

What the dispatcher reads and writes.

.agentify/index.db Read for planner ranking and routed context selection.
.agentify.yaml Read for default provider, context mode, and validation defaults.
.agentify/session/<id>/ Read on --continue; written when a session run is created.
.agentify/runs/ Run reports written for each provider invocation.
errors

Exit conditions visible in source.

No task and not interactive exits with a usage error. A missing or stale .agentify/index.db guides to agentify up when --skip-refresh is not set. A missing provider CLI exits with a provider-check failure and suggests agentify doctor.