niki run
Command reference, flags, and options for niki run.
niki run
Executes an end-to-end task through the multi-agent pipeline.
niki run <DESCRIPTION> [OPTIONS]
Arguments
<DESCRIPTION>: Natural language description of the coding task, feature, or bug fix.
Options & Flags
| Flag | Type | Description | Default |
|---|---|---|---|
--project <PATH> |
Path | Path to target project repository | . |
--branch <NAME> |
String | Explicit custom output branch name | niki/<task-id> |
--backend <KIND> |
docker | worktree |
Sandbox execution backend | docker |
--max-rounds <N> |
Integer | Maximum revision rounds between Reviewer and Coder | 3 |
--planner-model <M> |
String | Override model for the Planner stage | Config value |
--coder-model <M> |
String | Override model for the Coder stage | Config value |
--tester-model <M> |
String | Override model for the Tester stage | Config value |
--reviewer-model <M> |
String | Override model for the Reviewer stage | Config value |
--dry-run |
Flag | Generate plan and diff without applying or committing | false |
--tui |
Flag | Launch interactive rich terminal dashboard | false |
--quiet |
Flag | Suppress progress output and print only final branch/verdict | false |
--verbose |
Flag | Enable debug-level execution traces | false |