Odoo Kit
The all-in-one VS Code extension for Odoo 17+ development workflows.
Odoo Kit brings a purpose-built sidebar explorer, service control, real-time log viewer, Git shortcuts, and a guided module scaffold wizard — all tailored for Odoo developers.
Features
🗂️ Odoo Explorer
A dedicated sidebar tree that understands your Odoo project layout. Navigates community, enterprise, themes, industry, and custom addon paths simultaneously.
- Filter addons by name with a single click
- Install (
-i) or update (-u) any addon directly from the tree
- Full file management: new file/folder, rename, delete, cut/copy/paste
- Open files in split editor, compare two files, view Git timeline
- Open terminal at any folder, find in folder
- Add files or folders directly to AI chat context
⚡ Service Control
Start, stop, and restart the Odoo service without leaving VS Code.
- Status indicator in the Tools panel (running / stopped)
- One-click toggle, restart, and extra
-- argument configuration
- Opens
odoo.conf directly for quick edits
📋 Log Viewer
Real-time streaming log panel with filtering and colorization.
- Level filters:
ERROR · CRITICAL · WARNING · INFO · DEBUG
- Regex / text filter with live update
- Tail mode (auto-scroll to newest lines)
- Clear log with one click
- Color-coded by level for instant visual triage
🔀 Git Shortcuts
Per-repo Git actions accessible directly from the explorer tree.
- Branch selector, Fetch, Pull, Push
- Select file for diff / Compare with selected
🏗️ Module Scaffold
A 3-step guided wizard that generates a complete, standards-compliant Odoo module in seconds.
Step 1 — Base
- Module technical name, display name, version, summary, description
- Odoo version target (17 / 18 / 19)
- Author, company, license, website
- Module dependencies
Step 2 — Structure
- Choose which components to include: models, views, wizards, controllers, security, data, i18n, static assets
- Enable menus (creates
menus.xml)
Step 3 — Models
- Add any number of models
- New model: define
_name, _description, class name, fields (Char, Integer, Float, Boolean, Many2one, One2many, Many2many, Date, Datetime, Text, Html, Binary, Selection)
- Inherit model: extend an existing Odoo model (
_inherit), no boilerplate _name/_description noise
- Live file-structure preview updates as you type
Generated output:
my_module/
├─ __manifest__.py
├─ __init__.py
├─ models/
│ ├─ __init__.py
│ ├─ sale_order.py
│ └─ res_partner.py
├─ views/
│ ├─ sale_order_views.xml
│ ├─ res_partner_views.xml
│ └─ menus.xml
├─ security/
│ └─ ir.model.access.csv
├─ wizards/
├─ controllers/
└─ data/
Requirements
- VS Code
1.88.0 or higher
- Python extension (
ms-python.python) — required
- Git extension (built-in
vscode.git) — required
Extension Settings
| Setting |
Default |
Description |
odooKit.communityPath |
/opt/odoo/odoo |
Path to the Odoo community source |
odooKit.enterprisePath |
/opt/odoo/enterprise |
Path to the Odoo enterprise source |
odooKit.themesPath |
/opt/odoo/themes |
Path to the Odoo themes repository |
odooKit.industryPath |
/opt/odoo/industry |
Path to the Odoo industry repository |
odooKit.customAddonsPath |
/opt/odoo/extra-addons |
Path to your custom addons folder |
odooKit.configPath |
/etc/odoo/odoo.conf |
Path to odoo.conf |
odooKit.logPath |
/var/log/odoo/odoo-server.log |
Path to the Odoo log file |
odooKit.serviceArgs |
"" |
Extra arguments appended to the Odoo service command |
odooKit.scaffold.defaultAuthor |
"" |
Pre-filled author in the scaffold wizard |
odooKit.scaffold.defaultCompany |
"" |
Pre-filled company in the scaffold wizard |
odooKit.scaffold.defaultLicense |
Other proprietary |
Pre-filled license in the scaffold wizard |
odooKit.scaffold.defaultCopyrightHeader |
"" |
Copyright header added to generated Python files |
odooKit.scaffold.defaultInheritSuffix |
"" |
Default suffix appended to inherit model class names |
Keyboard Shortcuts
All shortcuts are active when the Odoo Explorer panel has focus.
| Shortcut |
Action |
Ctrl+Enter |
Open file in split editor |
F2 |
Rename file or folder |
Delete |
Delete file or folder |
Ctrl+X |
Cut |
Ctrl+C |
Copy |
Ctrl+V |
Paste |
Shift+Alt+C |
Copy absolute path |
Ctrl+K Ctrl+Shift+C |
Copy relative path |
Shift+Alt+F |
Find in folder |
Getting Started
- Install the extension and open VS Code.
- Click the Odoo Kit icon in the Activity Bar.
- Open Settings (
Ctrl+,) and search for odooKit to configure your paths.
- The explorer will automatically populate your addons tree.
- To scaffold a new module, click the + icon in the explorer toolbar or right-click any folder.
Known Issues
- Service control currently supports systemd-managed Odoo services only (Linux).
- Log viewer reads from a static file path; live tail requires read access to the configured log path.
Release Notes
0.0.1
Initial release:
- Odoo Explorer with multi-path addon navigation
- Service control (start / stop / restart)
- Real-time log viewer with level filtering
- Git shortcuts (branch, fetch, pull, push)
- Module Scaffold wizard (Odoo 17 / 18 / 19)
Contributing
Issues and pull requests are welcome at the GitHub repository.
License
Proprietary — © Digital Planet S.R.L. de C.V.
| |
