Quick Start

npx @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.

What You Get

| | | | --- | --- | | 🧱 Repeatable environments | Generate a predictable local Odoo setup for each product. | | 📦 Clean source layout | Keep private, OCA, and external addon repos separated under odoo/custom/src/. | | 🕹️ Daily cockpit | Start services, update modules, run tests, inspect logs, and manage snapshots. | | 🧪 Module workflow | Install, update, test, lint, translate, add, and remove Odoo modules. | | 🛟 Safe recovery | Use status, doctor, snapshots, restore, and safe reset deliberately. | | 🤖 Automation friendly | Use the cockpit or direct commands in scripts, CI jobs, and agent workflows. |

Daily Workflow

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

How It Works

Clean Source Layout

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

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

Learn More

• WPMoo.org
• Getting Started
• Cockpit Guide
• Command Reference
• Generated Environments
• Recovery Workflows

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.

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