kavi task
Enqueue a task for codex, claude, or auto routing.
Synopsis
kavi task <prompt> [options]Description
Submits a new task to the running Kavi session. The task is routed to either Codex, Claude, or automatically determined based on routing rules. By default, Kavi uses its layered routing strategy (heuristic rules, then LLM classifier, then user prompt) to decide which agent handles the task.
Options
| Flag | Description |
|---|---|
--plan | Run a planning pass before execution, decomposing the task into a DAG of subtasks |
--direct | Skip planning and execute the task directly |
You can also specify the target agent explicitly in the prompt or let Kavi auto-route.
Examples
# Submit a task with auto-routing
kavi task "Refactor the database connection pool"
# Submit with a planning pass
kavi task --plan "Build the user authentication flow"
# Submit for direct execution without planning
kavi task --direct "Fix the typo in the README"Related
- kavi tasks -- inspect the task list
- kavi task-output -- view output for a completed task
- kavi plan -- inspect the execution graph
- kavi route -- preview routing for a prompt