Skip to main content
When background processing is enabled, Claudeye exposes live queue status in several places. Use these to track progress, spot failures, and understand what’s been processed. To enable background processing, see Background Queue. The navbar shows a live badge with the count of pending + processing items. Click it to see:
  • Up to 7 current processing items with their names and session links
  • Pending items with priority badges (HIGH / LOW)
The badge disappears when the queue is empty.

​
/queue details page

Navigate to /queue for a full breakdown across three tabs: In Queue - pending items waiting to be processed:
  • Type badge (eval / enrichment)
  • Item name and session link
  • Priority (HIGH or LOW)
  • Time queued
Processing - items currently running:
  • Spinner, type badge, item name, session link
  • Time started
Processed - completed items (paginated, 25 per page):
  • Type badge, item name, session link
  • Duration
  • Success or failure icon
  • Completion time
Processed history is stored on disk and survives process restarts. The TTL is controlled by --queue-history-ttl (default: 1 hour).

​
Dashboard panel

The /dashboard page includes a collapsible queue panel showing:
  • Processing and pending tables
  • Background processor status indicator
  • Error list for any failed items
All views auto-refresh and self-hide when there’s no queue activity.

​
Cache invalidation

By default, cached eval results are reused until the session file changes or you edit the eval function. Use app.cacheInvalidation() to add custom logic - for example, re-running evals that scored 0 or results older than 24 hours. 
// Invalidate results older than 24 hours
app.cacheInvalidation(({ cachedAt }) => {
  const age = Date.now() - new Date(cachedAt).getTime();
  return age > 24 * 60 * 60 * 1000;
});
See Caching for the full reference.

​
Clearing the cache

claudeye --cache-clear
This clears all cached results and exits. On next startup, the background queue will re-process all sessions.