Skip to content

Getting Started

A terminal UI for Odoo instances, on this machine or on a remote host over ssh. One screen: host cpu/mem/uptime, every Odoo instance (systemd --user, supervisor or docker compose) with its databases nested underneath, and a detail pane for process/log/db inspection.

Installation

uv tool install odoo-activity
odoo-activity --version

Or with pip:

pip install odoo-activity

Quick example

# Watch this machine
oa

# Watch a remote host over ssh
oa odoo@somehost

# ...on a non-default ssh port
oa odoo@somehost -p 10113

Discovers Odoo instances under systemd --user, supervisor, odoo.sh and docker compose (all are merged), and needs the odoo-db CLI on PATH for the database category tabs. The Config tab additionally needs odoo-config and odoo-addons-path on PATH.

The Params tab shows ir_config_parameter secret-looking values unmasked by default — you already have a shell on this host. Pass --no-include-sensitive-information to keep odoo-db's own masking instead.

Continue to Keybindings & Tabs for the full reference.

See also

  • MCP Server — expose the same data to an agent, alongside a human on the TUI.
  • Architecture — module layout, managers, and where each tab's data comes from.