Custom agents

Custom agents

Any agent CLI you have installed can be a pane kind, alongside the built-in claude / opencode / pi.

Adding one

Preferences → Agents → Add custom CLI: set a binary name, a label, and an optional model flag.

How it's kept safe

• The binary must match a strict name pattern and resolve via command -v to a real file.
• Arguments are passed as literal argv, never joined into a shell string.
• Tome's backend re-vets the spawn line at pane creation — the custom agent is validated in the trusted path, then merged into the spawn allowlist.

This widens the spawn surface by design (it's your binary, your consent); the vetting above is what keeps a compromised renderer from requesting arbitrary commands.