Quick Start

Two commands set up every supported agent on your machine: Claude Code, OpenAI Codex and Google Antigravity. You need Node.js 24 or later.

1. Install Omnodex in the shell where your agents run:

   macOS / Linux

   npm install -g omnodex

   WSL

   In a WSL terminal:

   npm install -g omnodex

   This covers agents you start inside WSL. Desktop apps run on Windows; install there too, from PowerShell.

   Windows (PowerShell)

   npm install -g omnodex

   This covers the desktop apps and agents you start from PowerShell. Agents you run inside WSL need their own install there.

2. Set up your agents:

   omnodex install

   Omnodex finds the agents on this machine, shows what it will set up, and asks two questions: whether to go ahead, and whether to record every project you open (recommended) or only the current one. For each agent it installs the hooks and the Omnodex plugin. At the end it offers to connect the hosted dashboard; press Ctrl+C to skip that for now.

3. Start a new session in your agent. Agents load hooks and plugins when a session starts. Codex asks you to review new hooks the first time: run /hooks in Codex and trust the Omnodex entries.

4. Look at what was recorded:

   omnodex dashboard

   The local dashboard opens at http://localhost:7890 with the tool calls each agent made and any risks found. To use the hosted dashboard instead, run omnodex connect; see Choosing a Dashboard.

Cowork runs in the cloud and is set up from its own app; see the Cowork guide.

Next steps

• Installation: one agent at a time, leaving a project out, updating, uninstalling, and installing from source
• Windows and WSL: how the two Windows hosts fit together
• Running Detection: the risks Omnodex looks for and how to tune them