Dependence Levels

CodeTwin has five autonomy levels. Set it per run using --dependence-level.

Example:

codetwin run "refactor auth service" --dependence-level 3

Level 1 — Full supervision

Ask before every file write, delete, or shell command. Nothing executes without your approval. Best for unfamiliar codebases or high-risk refactors.

codetwin run "task" --dependence-level 1

Level 2 — Reads are free

Allows read-only actions automatically. Asks before write-like actions.

codetwin run "task" --dependence-level 2

Level 3 — Smart checkpoints (default)

Allows most actions. Still asks for explicit question/approval checkpoints.

codetwin run "task" --dependence-level 3

Level 4 — Destructive only

Allows all actions except destructive classes, which still require approval.

codetwin run "task" --dependence-level 4

Level 5 — Full delegation

Allows all actions and suppresses question prompts.

codetwin run "task" --dependence-level 5

Notes

• Valid range is 1 through 5.
• If omitted, default behavior is equivalent to level 3.
• You can keep daily work at a safer level and only raise autonomy for trusted, repetitive tasks.