Skip to main content

​
Install and run

1

Install Claudeye

Install globally with npm or bun:
npm install -g claudeye
Node.js >= 20.9.0 must be on your PATH.
2

Start the dashboard

Run claudeye from any directory:
claudeye
This opens your browser at http://localhost:8020 and reads sessions from ~/.claude/projects by default.
3

Browse your sessions

You’ll see a list of your Claude Code projects and sessions. Click any session to view the full execution trace: messages, tool calls, thinking blocks, and subagent logs.

​
Keep sessions longer

Claude Code deletes sessions older than 30 days by default. To keep more history visible in Claudeye, add this to ~/.claude/settings.json:
~/.claude/settings.json
{
  "cleanupPeriodDays": 9999
}
Do not set cleanupPeriodDays to 0. This immediately wipes all stored sessions.

​
Common options

FlagWhat it doesDefault
--projects-path <path>Path to your Claude projects directory~/.claude/projects
--port <number>Port to bind8020
--host <address>Use 0.0.0.0 to allow LAN accesslocalhost
--evals <path>Load a custom evals filenone
--auth-user <user:pass>Add an auth user (repeatable)none
--cache-clearClear all cached results and exitnone
--no-openDon’t auto-open the browsernone
--queue-interval <secs>Background scan interval in secondsdisabled
# Custom port, no browser
claudeye --port 3000 --no-open

# Load custom evals
claudeye --evals ./my-evals.js

# LAN access
claudeye --host 0.0.0.0

# Password-protect the dashboard
claudeye --auth-user admin:secret

# Enable background queue processing
claudeye --evals ./my-evals.js --queue-interval 60
See the full CLI Reference for all flags and environment variables.

​
Next steps

Browse sessions

Learn how to navigate projects, sessions, and subagent traces.

Set up evals

Grade your agent sessions automatically.