Agent command inventory

This page is generated from the canonical agent command registration surface in oduit.cli.app.

Command tiers:

• stable_for_agents: Recommended machine-facing surface for agents.

• beta_for_agents: Useful for agents, but still evolving in shape or behavior.

• human_oriented: Supported CLI surface, but documented primarily for humans.

• compatibility_only: Retained for migration or import compatibility only.

Canonical oduit agent commands

Command	Stability tier	Safety level	Summary
context	stable_for_agents	safe_read_only	Return a structured environment snapshot for automation.
inspect-addon	stable_for_agents	safe_read_only	Return a one-shot addon inspection payload.
addon-info	stable_for_agents	safe_read_only	Return a combined manifest, source, and runtime addon summary.
addon-doc	stable_for_agents	safe_read_only	Return a structured addon documentation bundle.
technical-doc	beta_for_agents	controlled_source_mutation	Create or preview addon-local arc42 technical documentation.
technical-evidence	beta_for_agents	controlled_source_mutation	Create or preview split deterministic technical evidence.
technical-report	beta_for_agents	controlled_source_mutation	Create or preview split LLM/human architecture report seed.
technical-doc-diff	beta_for_agents	safe_read_only	Diff report snapshots against current deterministic evidence.
technical-doc-refresh	beta_for_agents	controlled_source_mutation	Refresh managed blocks inside addon-local arc42 technical documentation.
technical-doc-accept	beta_for_agents	controlled_source_mutation	Accept a manually reviewed architecture document snapshot.
technical-doc-status	beta_for_agents	safe_read_only	Return tracking and freshness status for addon technical docs.
technical-doc-check	beta_for_agents	safe_read_only	Return freshness information for one technical-documentation target.
technical-doc-next	beta_for_agents	safe_read_only	Return the next addon that needs technical-documentation work.
plan-update	stable_for_agents	safe_read_only	Return a structured, read-only update plan for a module.
prepare-addon-change	beta_for_agents	safe_read_only	Bundle the common read-only planning steps for one addon change.
locate-model	beta_for_agents	safe_read_only	Locate likely source files for a model extension inside one addon.
locate-field	beta_for_agents	safe_read_only	Locate an existing field or suggest the best insertion point.
list-addon-tests	beta_for_agents	safe_read_only	List likely tests for an addon, optionally ranked by hints.
recommend-tests	beta_for_agents	safe_read_only	Map changed addon files to recommended tests and test tags.
list-addon-models	beta_for_agents	safe_read_only	List the models declared or extended by one addon.
find-model-extensions	beta_for_agents	safe_read_only	Find where a model is declared, extended, and installed.
get-model-views	beta_for_agents	safe_read_only	Fetch database-backed primary and extension views for a model.
doctor	stable_for_agents	safe_read_only	Return doctor diagnostics through the standard agent envelope.
list-addons	stable_for_agents	safe_read_only	Return structured addon inventory for the active environment.
list-installed-addons	stable_for_agents	safe_read_only	Return structured runtime installed-addon inventory.
dependency-graph	stable_for_agents	safe_read_only	Return a structured dependency and reverse-dependency graph.
explain-install-order	stable_for_agents	safe_read_only	Explain dependency cycles blocking install-order for automation.
inspect-addons	stable_for_agents	safe_read_only	Inspect multiple addons through the stable agent envelope.
resolve-config	stable_for_agents	safe_read_only	Return the resolved configuration with sensitive values redacted.
resolve-addon-root	stable_for_agents	safe_read_only	Resolve addon root paths for one module name.
get-addon-files	stable_for_agents	safe_read_only	Return a deterministic file inventory for one addon.
check-addons-installed	stable_for_agents	safe_read_only	Return runtime installed-state checks for one or more addons.
check-model-exists	beta_for_agents	safe_read_only	Check whether a model exists in source discovery and runtime metadata.
check-field-exists	beta_for_agents	safe_read_only	Check whether a field exists in runtime metadata and source.
list-duplicates	stable_for_agents	safe_read_only	Return duplicate addon names through the standard agent envelope.
inspect-ref	stable_for_agents	safe_read_only	Resolve one XMLID through the embedded Odoo runtime.
inspect-cron	stable_for_agents	controlled_runtime_mutation	Inspect one cron job and optionally trigger it.
inspect-modules	stable_for_agents	safe_read_only	Inspect module records from ir.module.module.
inspect-subtypes	stable_for_agents	safe_read_only	List message subtypes registered for one model.
inspect-model	stable_for_agents	safe_read_only	Inspect runtime model registration metadata.
inspect-field	stable_for_agents	safe_read_only	Inspect runtime field metadata.
db-table	stable_for_agents	safe_read_only	Describe one PostgreSQL table through the live Odoo connection.
db-column	stable_for_agents	safe_read_only	Describe one PostgreSQL column through the live Odoo connection.
db-constraints	stable_for_agents	safe_read_only	List PostgreSQL constraints for one table.
db-tables	stable_for_agents	safe_read_only	List PostgreSQL tables through the live Odoo connection.
db-m2m	stable_for_agents	safe_read_only	Inspect the relation table behind a Many2many field.
performance-slow-queries	stable_for_agents	safe_read_only	Read pg_stat_statements when the extension is available.
performance-table-scans	stable_for_agents	safe_read_only	Show tables with high sequential scan counts.
performance-indexes	stable_for_agents	safe_read_only	Show basic table index-usage metrics.
manifest-check	stable_for_agents	safe_read_only	Validate a manifest file and report structural warnings.
manifest-show	stable_for_agents	safe_read_only	Show manifest metadata for an addon or addon path.
install-module	stable_for_agents	controlled_runtime_mutation	Install a module with an explicit mutation gate.
update-module	stable_for_agents	controlled_runtime_mutation	Update a module with an explicit mutation gate.
uninstall-module	stable_for_agents	controlled_runtime_mutation	Uninstall a module with explicit runtime and destructive gates.
create-addon	stable_for_agents	controlled_source_mutation	Create a new addon with an explicit mutation gate.
export-lang	stable_for_agents	controlled_runtime_mutation	Export language files with an explicit mutation gate.
test-summary	stable_for_agents	controlled_runtime_mutation	Run tests and emit a normalized summary payload.
validate-addon-change	beta_for_agents	controlled_runtime_mutation	Validate an addon change with one aggregate structured payload.
preflight-addon-change	beta_for_agents	safe_read_only	Run a cheap read-only addon-change preflight.
query-model	stable_for_agents	safe_read_only	Run a structured read-only model query.
read-record	stable_for_agents	safe_read_only	Read a single record by id via OdooQuery.
search-count	stable_for_agents	safe_read_only	Count records matching a domain via OdooQuery.
get-model-fields	stable_for_agents	safe_read_only	Inspect model field metadata via OdooQuery.