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

Safety

Commands and file writes go through approval mode (tools.approvalMode). There is no OS command sandbox (Landlock, seccomp, Seatbelt, bubblewrap). Policy details: Approvals. Concepts: Permission model.

Task subagents can use filesystem isolation (CoW worktree backends via subagent.isolation.*) so their edits land in a private tree until merged. That is change-control for subagents, not an OS process sandbox. See the task tool docs, or the Isolation group in the Subagents settings tab.

Operator-visible cases

SituationResult
Command or edit needs permissionApproval prompt with command/path and cwd
Approval deniedDenial / tool failure; no partial escalation of rights
Tool JSON malformed but unambiguousSchema repair, then validation/dispatch
Tool JSON ambiguous or unrepairableError tool result to the model; no dispatch
Tool output truncatedTruncation recorded in the tool result
Config / provider data invalidLoad fails with path and context

Headless

veyyon --print has no TTY for prompts. Set --approval-mode / --yolo explicitly for the job. Reserve full auto-approve for disposable runners. See Non-interactive mode.