Agent compatibility registry

August 23, 2026 · View on GitHub

This registry describes the outer vetto integration contract. Built-in agent sandbox behavior changes independently, so an agent preset may add required read paths or environment names but must never weaken vetto's enforcement. Last tested is intentionally explicit; not in CI means compatibility is unproven rather than assumed.

AgentTypical commandBuilt-in isolationRecommended modePresetNetwork notesLast tested
OpenAI Codex CLIcodex, codex execYes; platform/config dependentstatusline for interactive, full/none for execcodexProvider and Git endpoints must be explicitly allowednot in CI
Claude Codeclaude, claude -pOptional/tool-specificstatusline for interactive, full/none for -pclaudeProvider and package endpoints depend on the tasknot in CI
AideraiderNo uniform OS boundary assumedstatuslineaiderModel provider plus optional Git endpointsnot in CI
Cursor Agentcursor-agentImplementation/version dependentfullcursorTreat endpoints as untrusted configurationnot in CI
Clineuser-configured CLI/extension commandunknownfullclineDo not infer endpoints from the presetnot in CI
OpenCodeopencodepermission model is not treated as an OS boundarystatuslineopencodeProvider-specificnot in CI
GitHub Copilot CLIcopilotimplementation/version dependentstatuslinecopilotGitHub endpoints only when needednot in CI
Custom processany executableunknownstatusline or nonecustomDefault remains offprocess contract covered

Compatibility rules

  1. The command must be executable from the policy's read scope.
  2. Interactive programs use a PTY; headless programs should use --tui=full or --tui=none.
  3. Credential variables are stripped unless a project policy explicitly opts into each name.
  4. An agent's own sandbox is defense in depth. vetto does not detect it and then remove outer restrictions.
  5. doctor --check-agent reports observed version/output only. It must not say “no conflicts” unless that exact version is covered by an automated test.