# Which Interface?

Use the smallest interface that matches the job.

- human CLI: `oduit ...` for interactive work and shell scripts
- agent CLI: `oduit agent ...` for structured inspection, planning, source
  localization, and gated mutations
- typed Python API: `OdooOperations`, `ModuleManager`, and typed models for
  programmatic integrations inside Python code
- unsafe executor: `OdooCodeExecutor` only for trusted arbitrary code, always
  with `allow_unsafe=True`

## Coding Agents

For external coding agents, treat `oduit agent ...` as the primary
automation surface.

Use {doc}`agent_contract` as the canonical guide for the recommended command
sequence, mutation policy, payload expectations, and failure handling.

Use {doc}`agent_command_inventory` for the generated agent command matrix and
its per-command stability tiers, and {doc}`command_inventory` for the
top-level CLI inventory.