# Welcome to oduit's documentation!

**oduit** is an Odoo CLI and Python utility layer focused on two things:

- running common Odoo workflows with structured results
- understanding addons through manifest, dependency, and series introspection

## Highlights

- `oduit doctor` for setup diagnostics
- structured JSON output for automation and CI
- addon intelligence commands such as `list-addons`, `list-depends`,
  `install-order`, `explain-install-order`, and `impact-of-update`
- split addon technical documentation workflows with deterministic evidence and
  LLM/human report files
- `oduit agent` as the primary automation surface for coding agents,
  including discovery, location, and verification flows such as
  `get-model-fields`, `locate-model`, `validate-addon-change`, and
  `test-summary`
- Python APIs for operations, addon analysis, typed planning models, and safe
  read-only queries

## Quick Start

```bash
oduit --env dev doctor
oduit --env dev version
oduit --env dev list-addons
oduit --env dev install-order sale,purchase
oduit --env dev explain-install-order sale
```

## Installation

```bash
pip install oduit
```

## Contents

```{toctree}
:caption: Contents:
:maxdepth: 2

installation
quickstart
technical_documentation
migrate-odoo-conf
agent_contract
agent_command_inventory
agent_output_audit
interfaces
cli
command_inventory
configuration
api
examples
changelog
```

## Indices and tables

- {ref}`genindex`
- {ref}`modindex`
- {ref}`search`