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

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