Non-Interactive Mode
Run Hanzo Dev headless for single tasks and CI/CD pipelines.
Non-Interactive Mode
Run Hanzo Dev without the TUI for single tasks:
dev exec "Add error handling to main.py"Options
| Option | Description |
|---|---|
--auto | Run Auto Drive instead of single turn |
--auto-review | Use Auto Review models and limits |
--json | Print events to stdout as JSONL |
--color <MODE> | Color output: always, never, auto |
--max-seconds <N> | Maximum wall-clock time budget |
--turn-cap <N> | Maximum Auto Drive coordinator turns |
--include-plan-tool | Include planning tool in conversation |
--output-last-message <FILE> | Write final message to file |
--output-schema <FILE> | JSON Schema for structured output |
--skip-git-repo-check | Allow running outside Git repos |
Examples
# Full auto mode (sandboxed)
dev exec --full-auto "Fix all linting errors"
# Auto Drive with time limit
dev exec --auto --max-seconds 300 "Implement the TODO items"
# JSON output for scripting
dev exec --json "List all functions in src/"CI/CD Integration
- name: Update changelog via Hanzo Dev
run: |
npm install -g @hanzo/dev
export OPENAI_API_KEY="${{ secrets.OPENAI_KEY }}"
dev exec --full-auto "update CHANGELOG for next release"Resuming Sessions
Resume a previous headless run to continue the same conversation:
# Resume most recent session
dev exec "continue the task" resume --last
# Resume specific session by ID
dev exec resume 7f9f9a2e-1b3c-4c7a-9b0e-123456789abc "continue"