Troubleshooting

No events being recorded

Symptom: You used Codex or Claude Code but ~/.eyes4ai/private/events/ is empty or unchanged.

Checklist:

Did you run eyes4ai install --global? Installing the npm package only puts the binary on your PATH. You must run eyes4ai install --global to configure your AI tools, set up git hooks, and start the daemon.
Did you restart your AI tool after install? Codex and Claude Code only read their config at startup. If they were already running when you ran eyes4ai install, they won’t emit telemetry until restarted. Quit and reopen the tool.
Is the daemon running?
Terminal window
```
curl http://127.0.0.1:4318/health
```
You should see {"ok":true,...}. If not, start it manually:
Terminal window
```
eyes4ai serve
```
Does the config exist?
- Codex: cat ~/.codex/config.toml — look for the [otel] block between # eyes4ai:begin and # eyes4ai:end
- Claude Code: cat ~/.claude/settings.json — look for OTEL_EXPORTER_OTLP_ENDPOINT in the env key

Symptom: The report shows AI activity but zero AI-linked commits.

Is the git hook installed?
Terminal window
```
git config --global core.hooksPath
```
Should return ~/.eyes4ai/hooks (or similar). Check the hook exists:
Terminal window
```
ls -la ~/.eyes4ai/hooks/post-commit
```
Is the hook executable?
Terminal window
```
chmod +x ~/.eyes4ai/hooks/post-commit
```

macOS: Check the launchd plist:

cat ~/Library/LaunchAgents/com.eyes4ai.server.plist

Reload it:

launchctl unload ~/Library/LaunchAgents/com.eyes4ai.server.plist
launchctl load ~/Library/LaunchAgents/com.eyes4ai.server.plist

Linux: Check the systemd service:

systemctl --user status com.eyes4ai.server
journalctl --user -u com.eyes4ai.server

If port 4318 is already in use, install with a custom port:

eyes4ai install --global 4319

cat ~/.eyes4ai/logs/eyes4ai.stdout.log
cat ~/.eyes4ai/logs/eyes4ai.stderr.log

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

Then restart any running Codex or Claude Code sessions.