WPMoo Toolkit

Appearance

WPMoo ToolkitA calmer Odoo development workflow.

Repeatable Odoo dev environments, clean addon repos, and one cockpit for daily module work.

Start in 3 commands
Read the docs
View on GitHub
WPMoo Toolkit logo

Repeatable environments

Generate a predictable local Odoo setup for each product.

Start here

Clean source layout

Keep private, OCA, and external addon repos separated under `odoo/custom/src/`.

Organize sources

Daily cockpit

Start services, update modules, run tests, inspect logs, and manage snapshots.

Open the cockpit

Module workflow

Install, update, test, lint, translate, add, and remove Odoo modules.

Work on modules

Safe recovery

Use `status`, `doctor`, snapshots, restore, and safe reset deliberately.

Recover safely

Automation friendly

Use the cockpit or direct commands in scripts, CI jobs, and agent workflows.

Automate checks

WPMoo Toolkit for Odoo development workflows

Quick Start ​

sh
$ npx @wpmoo/toolkit
$ cd <product>_dev
$ ./moo
sh
$ pnpm dlx @wpmoo/toolkit
$ cd <product>_dev
$ ./moo
sh
$ yarn dlx @wpmoo/toolkit
$ cd <product>_dev
$ ./moo
sh
$ bunx @wpmoo/toolkit
$ cd <product>_dev
$ ./moo

No long Docker commands. No guessing addon paths. No mixing generated runtime files with product source code.

Why Odoo Developers Use WPMoo ​

Every Odoo project tends to need the same setup work:

  • Docker Compose files.
  • Odoo and PostgreSQL runtime wiring.
  • Private, OCA, and external addon source repositories.
  • Module install, update, test, lint, and translation commands.
  • Snapshots before risky changes.
  • Diagnostics and recovery when generated files or databases drift.

WPMoo turns that recurring setup into one repeatable Odoo workflow.

Daily Workflow ​

bash
./moo start
./moo update my_module
./moo test my_module
./moo snapshot dev before-refactor
./moo doctor

How It Works ​

WPMoo Toolkit Odoo workflow

Clean Source Layout ​

text
odoo/custom/src/
|-- private/
|-- oca/
`-- external/

Your product source stays clean. Generated runtime files can be refreshed safely.

Learn More ​

Legacy aliases are documented in the command reference.

Status ​

WPMoo Toolkit is pre-1.0 and under active development.

It is already useful for local Odoo development workflows, but command behavior and setup conventions may still change before the first stable release.

License ​

WPMoo Toolkit is free software released under the MIT License.

It is independent from Odoo S.A. and is not affiliated with, endorsed by, or sponsored by Odoo S.A.