Skip to main content

​
Supported session types

Claudeye reads two types of session logs:
  • Claude Code: sessions stored in ~/.claude/projects (the default)
  • Claude Agents SDK: session logs written to disk by your Python or TypeScript agent code
Both appear in the same projects and sessions browser.

​
Projects and sessions browser

When you open Claudeye, you see a list of projects. Each project maps to a directory under your --projects-path. Click a project to see its sessions, sorted newest-first. You can filter by:
  • Date range: narrow to a time window
  • Keyword: search session content

​
Session view

Click a session to open the execution trace. You’ll see every event in the conversation:
Entry typeWhat it shows
User messagesInput sent to the model
Assistant messagesModel responses, including thinking blocks
Tool callsTools the model invoked and their inputs
Tool resultsOutputs returned to the model
System eventsMetadata like model selection, context window usage
The stats bar at the top shows turn count, tool calls, subagent count, session duration, and models used at a glance.

​
Subagent logs

If your session spawned subagents, you’ll see them listed under the parent session. Click any subagent to expand its trace inline. No separate navigation needed.
Subagent logs are pre-loaded with the session, so expanding them is instant regardless of size.

​
JSONL export

Each session page has a download button to export the raw JSONL log for that session.

​
Auto-refresh

To monitor a live session, use the auto-refresh controls on the session list: 5s, 10s, or 30s intervals. Claudeye will poll for new sessions and update the list automatically.

​
Using a custom projects path

If your sessions are stored somewhere other than ~/.claude/projects, pass the path at startup: 
claudeye --projects-path /path/to/my/projects
Or if you’re using the JS API: 
import { createApp } from 'claudeye';

const app = createApp();
app.listen(8020, { projectsPath: '/path/to/my/projects' });