Quick Start

1. Install and set up

npm install -g @eyes4ai/cli
eyes4ai install --global

That’s it. This configures Codex and Claude Code to send telemetry, installs a Git commit hook, and starts a background server that persists across reboots.

Restart your AI tools

If Codex or Claude Code is already running, restart it so it picks up the new config. Sessions started before install won’t emit telemetry.

2. Use your AI tools normally

Open Codex or Claude Code in any repo and work as usual. eyes4ai captures activity silently via OpenTelemetry.

3. Make some commits

Commit your work with Git as normal. The post-commit hook automatically records each commit and links it to recent AI sessions.

4. View your report

cd /path/to/your/repo
eyes4ai report

Output:

Period: last 7 days

  Sessions:              8  (codex: 5, claude: 3)
  Turns:                 42 (codex: 28, claude: 14)
  AI-active days:        5 / 7
  Estimated cost:        $12.84  (codex: $7.44, claude: $5.40)
  AI-linked commits:     11 / 18 (61%)
  Avg cost per commit:   $1.17

JSON output

For programmatic consumption:

eyes4ai report --json

Custom period

Default is 7 days. For a different window:

eyes4ai report --days 30