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
• Multi-selection with Ctrl / Shift — delete, cut, copy, and open multiple items at once
• Drag files from your OS file manager directly into the tree to copy them; conflict dialog on duplicates
• 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

⚙️ odoo.conf Visual Editor

A full-featured graphical editor for your odoo.conf — no more hand-editing INI files.

• All standard Odoo options organized in collapsible sections
• addons_path rendered as an interactive list: add folders via system picker, remove entries, and drag-and-drop to reorder load priority
• Path fields (logfile, pg_path, pidfile, GeoIP, SMTP certs, …) include a folder/file browser button
• Memory limit fields (limit_memory_hard, limit_memory_soft) show a live GB/MB hint as you type
• Orange dot marks any field that differs from the Odoo default; reset arrow restores it
• Sticky top toolbar with Save (or Ctrl+S), Discard, Collapse all / Expand all
• Unsaved-change counter badge so you always know what's pending

📋 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)
• Font size controls (increase / decrease / reset)
• Clear log with one click
• Color-coded by level; raw log lines displayed exactly as written by Odoo
• Log panel state persists when the panel is hidden or VS Code restarts

🔀 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

Keyboard Shortcuts

All shortcuts are active when the Odoo Explorer panel has focus.

Getting Started

1. Install the extension and open VS Code.
2. Click the Odoo Kit icon in the Activity Bar.
3. Open Settings (Ctrl+,) and search for odooKit to configure your paths.
4. The explorer will automatically populate your addons tree.
5. 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 requires read access to the configured log file path.

Release Notes

0.1.1

• New: Multi-selection in the Odoo Explorer — Ctrl/Shift-click to select multiple files or folders, then delete, cut, copy, or open them all at once
• New: Drag files and folders from the OS file manager (Windows Explorer, Finder) directly into the tree to copy them; shows a Replace / Replace All / Skip dialog on conflicts

0.1.0

• New: odoo.conf visual editor — collapsible sections, interactive addons_path list with drag-to-reorder, path browser buttons for file/folder fields, live GB/MB hints for memory limit fields, sticky Save / Discard / Collapse-all toolbar, unsaved-change badge, Ctrl+S to save
• New: Auto-reveal active file in Odoo Explorer (opens and selects the file matching the active editor tab)
• New: ODOO TOOLS panel — Workers view showing PID, command line and process type for each worker
• Improved: Explorer auto-refreshes on file system changes without a manual refresh
• Improved: Log viewer now appends new lines incrementally instead of re-rendering on every update
• Performance: Caches for addon scans, manifest checks, exclude patterns, and VS Code configuration

0.0.1

• New: odoo.conf visual editor — collapsible sections, interactive addons_path list with drag-to-reorder, path browser buttons, live GB/MB hints for memory fields, sticky Save/Discard toolbar
• New: Auto-reveal active file in Odoo Explorer (opens and selects the file matching the active editor)
• New: Git branch status bar item showing the branch of the selected tree node
• Improved: Log viewer now shows raw Odoo log lines with color-coding, font size controls, and persists state when the panel is hidden
• Fixed: Log viewer was reading the wrong path — now always resolves logfile from odoo.conf first
• Fixed: Changing service arguments now immediately reflects in the ODOO TOOLS panel
• Fixed: Install / Update addon operation now restarts the service automatically if it was running before
• Performance: Caches for addon scans, manifest checks, exclude patterns, and VS Code configuration; incremental log append; cancellation tokens for async tree operations

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.