odouche

An unofficial toolkit for working with Odoo.sh from your development environment: list branches, watch builds, stream logs, from a script, a terminal or an agent.

Unofficial. This project is not affiliated with, endorsed by, or supported by Odoo S.A. Odoo.sh has no public API: odouche talks to what the Odoo.sh web interface uses, which can change without notice.

Pre-alpha. The library and the osh command log in, list projects, branches and builds, watch a build, read and follow its logs and start a rebuild, and osh ssh opens a shell on a build with your own ssh: the CLI guide has the commands. The MCP server reports its session, lists projects, branches and builds, reads one build and its logs and, when you allow it, starts a rebuild.

Packages

Package	What it is
odouche	A Python library: the client for Odoo.sh, usable in your own tools.
odouche-cli	The osh command, in the spirit of gcloud, aws and scw.
odouche-mcp	A Model Context Protocol server, for development agents.

The command-line tool and the MCP server are built on the library, and only on its public interface.

Credentials

odouche never sees, stores or logs your password or your GitHub token. The security model says what it does keep, where, and for how long.

Development

Requires uv and make.

make install   # install the workspace and the git hooks
make check     # format, lint, types, dependencies, dead code, tests with coverage, docs
make help      # everything else

CONTRIBUTING.md has the conventions, and SECURITY.md how to report a vulnerability.

License

MIT