Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Non-interactive mode (veyyon --print)

--print (short -p) runs Veyyon without the interactive TUI: one prompt, tools run under the active approval mode, then exit. Use this from scripts, CI, and other programs.

$ veyyon -p "add a unit test for parse_config and run it"
$ echo "summarize the diff on this branch" | veyyon -p
$ veyyon -p - <<'EOF'
Review src/auth.rs for missing error handling.
EOF

The prompt may be a CLI argument or stdin. If both are present, the piped stdin content is prepended to the argument prompt (stdin first, then the argument, separated by a newline).

Run veyyon --help for the generated flag set. Common options:

Session and config

OptionEffect
--no-sessionDo not persist the session (an ephemeral run)
--no-rulesDo not discover or load rules files
--no-skillsDo not discover or load skills
--profile <name>Activate a named profile (-p is --print, not profile)
--config <file>Load an extra config overlay for this run, repeatable and never persisted
--cwd <DIR>Working directory for the session
--allow-homeStart in your home directory instead of auto-switching to a temp dir

Output and models

OptionEffect
--mode jsonMachine-readable event stream on stdout
--model / role flagsModel selection for the run
--approval-mode / --yoloApproval policy for the run

Headless runs have no TTY for approval prompts: choose a mode that does not block (--yolo only on disposable runners) or expect the turn to stop when a prompt would be required. See Approvals.