Maurice

A local, read-only web explorer for your ~/.claude folder — built around your personal workflow (sessions by skill, ticket, branch), with estimated cost and context window usage.

Complements ccusage (CLI costs) and awa:skill-stats: here you explore and re-read conversations, not just crunch stats.

Screenshots

The data below is real; only confidential bits (conversation content, project names, tickets, branches) are blurred. Theme: Maurice Nuit.

Dashboard — analytics over a period: KPIs, activity charts, cost by model / skill / project.

Sessions — searchable, filterable list with estimated cost, peak context fill, errors and subagents.

Session detail — readable thread with the context-window fill curve and a cost / token panel.

Workflow — cost pivoted by skill / ticket / branch.	Timeline — sessions as time-positioned bars, colored by model.

MCP server — live, self-describing tool docs (read-only).

Getting started

npm install
npm run dev      # Vite :5173 (UI) + Express API :5174, with proxy
# → http://localhost:5173

Production build:

npm run build
npm start        # serves dist/ + API on http://localhost:5174

What it shows

• Dashboard — analytics overview over a period (7 / 30 / 90 days / all): KPIs (cost, tokens, sessions, cost per session, cache-hit %, error rate), activity charts (cost & sessions over time, day×hour heatmap), cost breakdown by model / skill / project, most expensive sessions, token composition, context-peak distribution, and MCP tool usage. Cards link through to filtered Sessions.
• Sessions — all sessions: project, ticket, skills, date, messages, tokens, estimated cost, peak context window fill, error badge, subagent count. Full-text search + filters (project / ticket / skill / model / MCP / errors). Includes a branch column and an active session indicator in the topbar.
• Detail — readable thread (errors highlighted, thoughts collapsible), context window fill curve (drop = compaction), cost/token panel, MCP tools called, subagents (clickable transcripts), and a "copy claude --resume <id>" button. First/last page navigation buttons (⟪ / ⟫).
• Workflow — sessions pivoted by skill (default), ticket, or branch, with per-group aggregates. Tokens/cost in the skill pivot are attributed per message (attributionSkill), so no double-counting across skills.
• Timeline — Gantt-style view of sessions as time-positioned bars, grouped into lanes by ticket (default), branch, or project, colored by model, with a period filter.
• Memory — browse and delete entries from ~/.claude/projects/*/memory/.
• Plans — browse, rename and delete plan-mode markdown files from ~/.claude/plans/ (global) and each project's .claude/plans/, grouped by date / folder / ticket.
• Hooks — browse the hook commands configured in settings.json (global / project, plus their .local variants), grouped by event and filterable by scope.
• MCP — install instructions for the MCP server (see below) and the live list of its tools — parameters, types, descriptions — sourced from the server itself so it never drifts.
• Bilans — periodic summaries generated by the awa:bilan skill, listing completed work and key decisions per period.

MCP server

Maurice also exposes its read-only data as an MCP server, so an agent can query your Claude Code history directly. It is served by the same Express process on /mcp (streamable HTTP), loopback-only with DNS-rebinding protection — start Maurice (npm run dev or npm start), then register it:

claude mcp add --transport http maurice http://localhost:5174/mcp

Tools (all read-only): search_sessions, list_sessions, get_session, list_memories, list_bilans, read_bilan, cost_summary, filters. Cost stays an estimate (see below).

Technical notes

• Reads process.env.CLAUDE_DIR ?? ~/.claude. Read-only, except the explicit user-driven file operations: deleting a memory entry, and deleting/renaming a plan. Caches stay in the project-local .cache/.
• Streaming parser; session index disk-cached (.cache/), invalidated by (size, mtime) — first run takes a few hundred ms, subsequent runs are near-instant.
• Cost is an estimate (server/pricing.ts): Claude Code subscriptions report costUSD: 0, so cost is derived from public API pricing per model. Adjust the table freely.

Environment variables

Var	Default	Purpose
CLAUDE_DIR	~/.claude	source directory (read-only)
PORT	5174	API / production server port
CONTEXT_WINDOW	200000	window size for fill ratio
PERF	(off)	set 1 for per-request API timing logs

License

MIT © Awalgawe.

Maurice is an unofficial, independent tool and is not affiliated with, endorsed by, or sponsored by Anthropic. "Claude" and "Claude Code" are trademarks of Anthropic. It only reads your local ~/.claude data and never transmits it anywhere.