Skip to main content

​
Usage

claudeye [options]

​
Flags

FlagDescriptionDefault
--projects-path, -p <path>Path to Claude projects directory~/.claude/projects
--port <number>Port to bind8020
--host <address>Host to bind (0.0.0.0 for LAN access)localhost
--evals <path>Path to evals/enrichments JS file-
--auth-user <user:pass>Add an auth user (repeatable)-
--cache-path <path>Custom cache directory~/.claudeye/cache
--cache-clearClear all cached results and exit-
--no-openDon’t auto-open the browser-
--queue-interval <secs>Background scan interval in secondsdisabled
--queue-concurrency <num>Max parallel items per batch2
--queue-history-ttl <secs>Seconds to keep completed queue items3600
--max-queue-items <num>Max items to enqueue per scan (0 = unlimited)500
--logging <level>Log level: info, warn, errorwarn
-h, --helpShow help-

​
Environment variables

VariableDescriptionDefault
CLAUDEYE_QUEUE_INTERVALBackground scan interval in secondsdisabled
CLAUDEYE_QUEUE_CONCURRENCYMax parallel items per batch2
CLAUDEYE_QUEUE_HISTORY_TTLSeconds to keep completed items3600
CLAUDEYE_QUEUE_MAX_ITEMSMax items to enqueue per scan500
CLAUDEYE_AUTH_USERSComma-separated user:pass pairs-
CLAUDEYE_LOG_LEVELLog verbosity: info, warn, errorwarn
CLAUDEYE_EVALS_MODULEPath to evals file (alternative to --evals)-

​
Examples

# Default: opens browser at localhost:8020
claudeye

# Custom projects directory
claudeye --projects-path /path/to/projects

# Different port, no browser
claudeye --port 3000 --no-open

# Allow LAN access
claudeye --host 0.0.0.0

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

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

# Multiple auth users
claudeye --auth-user admin:secret --auth-user viewer:readonly

# Use a custom cache directory
claudeye --cache-path /tmp/claudeye-cache

# Clear all cached results and exit
claudeye --cache-clear

# Enable background queue (scan every 60 seconds)
claudeye --evals ./my-evals.js --queue-interval 60

# Background processing with higher concurrency
claudeye --evals ./my-evals.js --queue-interval 30 --queue-concurrency 5

# Verbose logging
claudeye --logging info

​
Log levels

LevelOutput
infoAll log lines, including ACTIVITY lines for user actions
warn (default)Warnings and errors only
errorErrors only