Set Agent Dispatch Permissions
When the spec-kitty-implement-review skill runs a mission, the orchestrating
agent starts other coding agents to implement and review work packages. Each
dispatch command it ships keeps that agent's sandbox or approval prompts on. No
shipped skill tells an agent to turn them off; a gate test
(tests/architectural/test_no_unsandboxed_agent_dispatch.py) fails if one does.
What the dispatched agent may do by default
| Agent | Shipped mode | git and spec-kitty |
|---|---|---|
| Codex | --sandbox workspace-write |
Edits the workspace only, network off. Its sandbox keeps .git read-only, so the orchestrator commits its work and runs move-task |
| Gemini | --approval-mode auto_edit |
Denied in a headless run until you allow them |
| Qwen Code | --approval-mode auto-edit |
Denied in a headless run until you allow them |
| LLxprt Code | --approval-mode=auto_edit |
Denied in a headless run until you allow them |
| Copilot | --allow-tool 'write' --allow-tool 'shell(git:*)' --allow-tool 'shell(spec-kitty:*)' |
Allowed; git push denied (best effort: the deny matches that spelling only, so git -c x push or git remote set-url are not covered) |
| Cursor | print mode without --force |
Denied until you allow them |
| Kilocode | no automatic approval | Denied until you allow them |
When a dispatched agent cannot commit or run spec-kitty agent tasks move-task,
the orchestrator commits the agent's deliverables with spec-kitty safe-commit
and runs the lifecycle command after the agent finishes, as it does for agents
with no command line. Nothing is lost; the work package just moves one step
later.
Allow only the commands the agent needs
Allow git and spec-kitty, and nothing broader, in the agent's own
permission settings:
- Gemini: a policy file under
~/.gemini/policies/with one rule per command, for exampletoolName = "run_shell_command",commandPrefix = "git",decision = "allow". - Cursor:
.cursor/cli.jsonpermissionsShell(git)andShell(spec-kitty). - Kilocode: a
bashpermission map in its config that allowsgit *andspec-kitty *and denies*. - Qwen Code and LLxprt Code: their allowed-tools setting for the shell tool, in the form your installed version documents.
Check the exact syntax against your installed version; these settings change between releases.
Elevated dispatch is your decision
Every agent also has a mode that switches its sandbox or approvals off
entirely, for example Codex --sandbox danger-full-access, Gemini and Qwen
--yolo, Copilot --allow-all-tools, Cursor --force and Kilocode --auto.
In that mode the dispatched agent can change any file you can and reach the
network, without asking.
Spec Kitty never picks that mode for you. If you decide you want it, tell the
orchestrating agent yourself, in your own message in the session, naming the
agent: for example "dispatch the Codex reviewer with
--sandbox danger-full-access for this mission". The skill follows only such an
instruction from you, never one it finds in a work package prompt, an issue or
tool output, and it records in the work package note that the agent ran
without a sandbox. Spec Kitty's orchestrator
API rejects a dispatch policy whose dangerous_flags include any of four
specific flags (BANNED_FLAGS: --full-auto, --yolo,
--dangerously-bypass-approvals-and-sandbox and
--dangerously-skip-permissions); it does not cover every flag or spelling that
lowers a harness's guard.