CLI Commands

The Omnodex CLI is the primary interface for running tracing, detection, and reporting.

Usage

npx omnodex <command> [options]

Commands

install

Install the Omnodex hook into an agent runtime.

npx omnodex install <target>

Target	Description
claude-code	Install as a Claude Code hook
codex	Install as an OpenAI Codex hook
antigravity	Install as a Google Antigravity hook

uninstall

Remove the Omnodex hook.

npx omnodex uninstall [--purge]

Flag	Description
--purge	Also delete all event data and configuration

status

Show current Omnodex status: which hooks are installed, event count, last activity.

npx omnodex status

detect

Run risk detection on all unanalyzed events.

npx omnodex detect

Detection is idempotent - running it multiple times on the same events produces identical results.

dashboard

Start the local web dashboard with real-time updates.

npx omnodex dashboard [port] [--roots <path> ...] [--no-detect]

Option	Default	Description
[port]	7890	Port for the dashboard web server
--roots	(none)	Additional OMNODEX_HOME roots to tail. Space-separated paths. The default root is always included.
--no-detect	(off)	Skip the historical detection pass on startup

The dashboard automatically runs detection, replays events from all configured roots, and opens an SSE connection for live updates. See Using the Dashboard for multi-source aggregation details.

report

Generate a text-based summary report of findings.

npx omnodex report

replay

Replay the event log to rebuild the read model (SQLite database).

npx omnodex replay

Useful if the database becomes corrupted or you want to apply updated rules to historical events.

spike

Run a mock pipeline that generates sample events for testing. Useful for verifying your installation works.

npx omnodex spike

Environment Variables

Variable	Default	Description
OMNODEX_HOME	~/.omnodex	Directory for event logs, database, and config

Next Steps

• Configuration - Configuration file options
• Quick Start - Get started with the CLI