Docs / Workflow guides

Guides for the core product workflows

Use these route-by-route walkthroughs after installation. They are written to help new users understand the dashboard surfaces quickly, with current screenshots alongside the instructions.

/dashboard

Get started quickly

Launch the dashboard, confirm that the local database is ready, and import your latest sessions.

  1. Open the dashboard Start the app, then land on the dashboard to see overall usage metrics and recent activity.
  2. Run a sync Use the Sync Claude Data action to refresh session metadata after new local conversations land.
  3. Check the active ticker Use the top bar to confirm whether active sessions are already streaming into the dashboard.
Dashboard overview Key usage metrics, sync actions, and recent session activity in one view. Click image to expand

/sessions

Browse and filter sessions

Find the sessions that matter by filtering status and drilling into the projects with the highest activity.

  1. Open Sessions Use the Sessions view to inspect project names, timestamps, message counts, token totals, and cost.
  2. Filter by status Switch between All, Active, Completed, and Error to narrow down the conversations you need.
  3. Open a detail page Select View on any row to inspect the summary, files touched, folders accessed, and full conversation.
Sessions list Filterable session inventory with message, token, and cost summaries. Click image to expand

/analytics

Analyze workflow health

Use the analytics dashboard to understand completion rate, tool mix, busiest projects, and transcript hotspots.

  1. Open Analytics Start on the analytics dashboard when you want a higher-signal view of recent usage than the main landing page.
  2. Read the KPI strip first The top metrics summarize sessions, active projects, completion rate, and average session size for the selected time window.
  3. Use charts and leaderboards to find hotspots Scan trend lines, tool mix, hourly activity, project ranking, and file or folder hotspots to see where effort is concentrating.
Analytics overview Operator dashboard with KPI cards, trend charts, tool mix, project leaderboard, and hotspots. Click image to expand

/sessions/demo-session-active

Inspect a single session

Use the detail view to understand what happened in a run before sharing results or following up.

  1. Read the summary first The summary gives you a compact explanation of the work before you scroll through messages.
  2. Scan files and folders Check the side panels to see what changed and which directories the session traversed.
  3. Review tool usage Use the timeline to inspect text exchanges, tool calls, and tool results in chronological order.
Session detail Deep dive into one conversation with summary, files, folders, and message history. Click image to expand

/monitoring/sessions

Monitor live work

Watch active sessions in the tiling monitor and pull up history even before new events arrive.

  1. Open the Tiling Monitor The monitor now preloads active sessions from the database so you can start watching immediately.
  2. Toggle AUTO-OPEN and AUTO-CLOSE Use the toggles to control whether new sessions appear automatically and finished ones disappear.
  3. Load older history on demand Use the history controls inside each tile to pull in more terminal-style context without leaving the page.
Tiling monitor Real-time terminal-inspired monitoring for active sessions. Click image to expand

Built from repository content with npm run pages:build.