Tools

CodeTwin uses a defined toolset to inspect code, modify files, run commands, and delegate subtasks. Tool execution visibility and approvals depend on your dependence level.

Read and discovery tools

• read
• list
• glob
• grep
• codesearch
• websearch
• webfetch
• lsp
• skill

These tools gather context without directly changing your workspace.

Edit and write tools

• edit
• write
• multiedit
• patch
• todowrite

These tools create or modify files and plans.

Execution tools

• bash
• task

bash runs shell commands. task delegates to a subagent.

Approval behavior by level

• Level 1 asks before all actions.
• Level 2 auto-allows read/discovery and asks on write-like actions.
• Level 3 auto-allows most actions with selective checkpoints.
• Level 4 asks for destructive classes.
• Level 5 runs with full delegation.

Extending with project tools

Custom project tools can be added under your repository .codetwin tools/plugin directories.

Common patterns:

• .codetwin/tools for tool implementations
• .codetwin/plugin for event hooks/integrations

Use these for project-specific automation that the agent can call during tasks.