Skip to content
Omnodex Omnodex Omnodex Docs

Quick Start

This guide gets you from zero to a working Omnodex installation with live risk detection. The whole process takes under five minutes.

Prerequisites

Section titled “Prerequisites”
  • Node.js 24+ (required for the built-in SQLite module)
  • npm (comes with Node.js)
  • An AI coding agent: Claude Code or OpenAI Codex

Install

Section titled “Install”

  1. Clone and build Omnodex:

    Terminal window
    git clone https://github.com/omnodex/omnodex.git
    cd omnodex
    npm install && npx tsc -b

  2. Install the hook into your agent:

    Terminal window
    npx omnodex install claude-code

    This registers Omnodex as a Claude Code hook. The next time Claude Code runs, all tool calls will be traced automatically.

  3. Run your agent normally. There is nothing else to configure. Omnodex intercepts in the background with zero impact on the agent’s behavior.

  4. View results:

    Terminal window
    npx omnodex dashboard

    Opens the Omnodex dashboard at http://localhost:7890 with a real-time view of all traced events and risk findings.

What You Should See

Section titled “What You Should See”

After running your agent with Omnodex installed, the dashboard shows:

  • A timeline of all tool calls and actions the agent took
  • Risk indicators flagging any concerning behavior (credential exposure, sensitive file access, unexpected network calls)
  • Full context for each event - what was called, with what parameters, and what it returned

Next Steps

Section titled “Next Steps”