Overview
The dashboard is a single-page application with a 196px fixed sidebar and a scrollable main area. URL parameters support deep-linking: ?proj=<path> switches project context and &sess=<id> opens a specific session.
| Topbar Element | Description |
|---|
| Live dot | Pulses green when an active Claude Code session is detected |
| Today cost badge | Cumulative USD spend for the current calendar day |
| Session cost ticker | Running cost of the currently focused session, updates in real time |
| Activity chip | Current agent type and task description from the most recent hook event |
| ⬡ Mastermind | Opens the Mastermind overlay (violet hexagon button) |
| ⚑ Budget | Opens a modal for setting daily and monthly spend limits (USD). Fields: Daily limit, Monthly limit. Once saved, the alerts rail shows a warning when actual spend approaches the limit. |
| ⌘K Search | Opens the command palette for cross-view navigation |
| ? Help | Shows keyboard shortcuts reference |
| ↺ Refresh | Force-reloads current view data |
Status strip (shown below topbar when data is present):
| Chip | Meaning |
|---|
| HNSW ON / OFF | Whether the HNSW vector index is loaded and searchable |
| PATTERNS N | Number of learned routing patterns in AgentDB |
| CHUNKS N | Number of indexed text chunks available for semantic search |
| SWARM topology | Active swarm topology name (hierarchical, mesh, adaptive…) |
| LAST ROUTE | Agent name that the routing hook most recently selected |
The sidebar footer shows your GitHub username and the absolute path of the current working directory.
Now — Live Feed
The Now view is a three-column layout: feed pane (left), optional detail panel (slides in from the right edge of the feed), and metrics pane (252px, fixed right).
| Feed Control | Key | Behavior |
|---|
| Play / Pause | Space | Toggle live-tail; pausing freezes the list without disconnecting |
| Clear | — | Removes all entries from the visible feed buffer |
| Filter | / | Opens inline search — filters entries by text or tool name |
| Jump to live | G | Scrolls to the newest entry and resumes live-tail |
| Ambient mode | A | Hides all chrome; only the feed remains |
| Replay | — | Re-plays the current session from the beginning at configurable speed |
| Focus | F | Expands the feed to full width, hiding metrics pane |
| Export | — | Downloads visible feed entries as JSONL |
Feed entry types:
| Type | Appearance |
|---|
| Tool events | Colored category icon (file, bash, web, memory, agent…), tool name, condensed args |
| User messages | Italic text with a person icon and timestamp |
| Error entries | Red left border, error message, optional stack trace expand |
Additional feed UI elements:
- Session context bar — pinned at top of feed: session ID, model, start time, current cost
- Recap card — collapsible summary of the previous session's key decisions
- Replay bar — scrubber, speed selector (0.5×, 1×, 2×, 4×), play/pause when in replay mode
- Timeline bar — horizontal ruler showing tool-call density over session time
- Time-range filter — drag handles on the timeline to zoom into a time window
- Weekly card — dismissible summary card (stored in localStorage) showing 7-day stats
- Daily digest card — dismissible AI-generated digest of today's activity
- Feed minimap — 8px-wide column of colored pips on the right scroll edge for quick navigation
Group rows — when 3 or more consecutive events share the same category, they are collapsed into a single row showing the count and a ▸ expand affordance. Clicking the group row expands all entries in place.
Detail panel: slides in 280px when an entry is clicked. Shows full event metadata, raw JSON payload, and a Copy button.
Metrics pane groups (252px, right):
| Group | What it shows |
|---|
| Today | Today API cost, call count, and a 7-day activity sparkline |
| Active Loops | Running loop names with live countdown timers |
| Recent Sessions | Last 5 sessions with cost and duration chips |
| Tool Usage | Bar chart of most-called tools in the current session |
| Burn Rate | Three rolling gauge rows — 5 min, 15 min, 60 min — each showing tool-call rate in calls/minute. Color: green < 4 calls/min, amber 4–10, red ≥ 10 |
| Session Lanes | Parallel swimlanes showing concurrent agent activity |
| Cache Efficiency | Per-session cache hit rate rows (cached tokens / total input tokens), with the rolling average shown in the group header. |
| Token Velocity | Tokens/minute sparkline for the current session |
| 30-Day Cost Trend | Bar chart of daily spend over the last 30 days |
| Activity Heatmap | Hour-of-day × day-of-week grid colored by event density |
Projects
Projects are discovered from Monomind's config registry. The view renders an auto-fill card grid (min 240px) with a filter input at the top.
| Card Element | Description |
|---|
| Active badge | Green "ACTIVE" pill — shown when the project's directory is the current working directory |
| Health score circle | 0–100 score: green ≥ 70, amber 40–69, red < 40 |
| Name & path | Project display name and filesystem path |
| Sessions count | Total recorded sessions for this project |
| Memories count | Number of memory files scoped to this project |
| Last active | Relative time since the last session event |
Clicking a card switches the global project context (updates the ?proj= URL param) and navigates to the Sessions view filtered to that project.
Sessions
Sessions are created automatically when you use Claude Code in any project. Start a session by opening Claude Code in your project directory:
Sessions are grouped by recency: Today, Yesterday, This week, Older — each group header is collapsible. A 12-week clickable calendar heatmap appears above the session list. Each cell represents one day; opacity scales with session count. Clicking a cell filters the session list to that day. The heatmap header shows a week-over-week delta indicator (e.g. ↑12%, ↓5%, → flat).
Each session row includes:
- Prompt text (truncated) with expand on hover
- Timestamp (relative) and compacted badge (when the session was auto-compacted)
- Summary excerpt — 2-line clamp of the AI-generated session summary
- Meta line:
duration · N messages · $cost
- Anomaly badges:
costly (cost > 2× average) and errors (tool errors detected)
- Auto-tags: topic tags inferred from session content (e.g.
refactor, bug-fix)
- File chips: up to 5 file paths touched in the session
- Context saturation bar: horizontal progress showing % of context window consumed (message count vs. limit)
- Notes — each row has a ✎ notes toggle (shown in blue when a note exists). Click to expand an inline textarea for free-form notes stored in localStorage, keyed by session ID.
- Error drawer — the error anomaly badge (N err) is clickable. Clicking it toggles an inline drawer below the row listing all tool error messages from that session.
- Custom tags — a '+ tag' affordance on each row adds manually typed labels (stored in localStorage). Custom tags appear as blue-toned pills alongside auto-tags and are included in the sessions filter.
- Context window pressure gauge — a separate 3px bar based on actual input token count vs the 200k context ceiling. Color: green (normal), amber (warn), red (critical). Shows a 'N% ctx' label. Distinct from the message-count saturation bar.
Toolbar toggle buttons:
| Button | Effect |
|---|
| Starred | Filter to bookmarked sessions only |
| Leaderboard | Sort by cost descending — shows most expensive sessions first |
| Models | Show model name chip on each row |
| Errors | Filter to sessions that contain tool errors |
| Tools | Show tool-call summary chips on each row |
| Projects | Show project path chip on each row |
| CSV | Export current filtered session list as CSV |
| Patterns | Show learned routing pattern badges |
| Compare | Enable multi-select mode for session diff (select exactly 2) |
| Timeline | Switch to a Gantt-style timeline visualization |
| Donut | Show a cost-by-model donut chart above the list |
| Report | Opens the Report Card modal with a structured plain-text summary of session activity for the current period. Includes a ⎘ Copy button — content is copied to clipboard, not downloaded. |
Period filter: Day / Week / Month / All — scopes the session list and heatmap to the selected window. Bulk actions become available when multiple rows are checked: Export, Bookmark, Clear.
Session diff: selecting exactly 2 sessions with Compare mode opens a side-by-side panel showing cost delta, duration delta, tool overlap, and unique tool calls per session.
Loops
Loops are created manually from the dashboard (+New Loop button) or via slash commands:
/mastermind:autodev --tillend
/mastermind:review --tillend --auto
/monomind:repeat --every 1h /mastermind:autodev
A loop is a scheduled automation: a prompt that re-runs at a fixed interval until a max-rep limit is reached or it is manually stopped.
| Loop Card Element | Description |
|---|
| Name | Human-readable loop label |
| Interval chip | Repeat cadence (e.g. 1h, 30m, daily) |
| Countdown timer | Live seconds-ticking countdown to the next run |
| Progress bar | currentRep / maxReps fill bar |
| Status badge | running, paused, or completed |
| Stop button | Immediately cancels the loop and records final state |
Expand a loop card to see: full prompt text, interval, started-at timestamp, last-run timestamp, run count, and a sparkline of per-run duration history.
Create Loop form fields:
| Field | Required | Default |
|---|
| Prompt | Yes | — |
| Name | No | Auto-generated from prompt |
| Interval | No | 1h |
| Max Reps | No | Unlimited |
Tokens
Token data is collected automatically from every Claude Code session. No setup required — costs appear as soon as API calls are made.
The Tokens view provides cost and usage analytics with period-based filtering.
💵
Today Cost
Cumulative USD spend for the current calendar day across all sessions
📞
Today Calls
Total API calls made today
📅
Month Cost
Spend for the current calendar month
🔢
Total Tokens
Cumulative input + output tokens across all recorded sessions
Period tabs — Today / Week / 30 Days / Month — each fetches /api/token-usage?period=X and re-renders the chart and table.
Animated bar chart: 400ms ease-out-cubic entrance animation. Bar colors follow threshold logic:
- Green — cost < average × 0.5 (low spend day)
- Amber — cost in normal range
- Red — cost ≥ average × 1.5 (high spend day)
The current day's bar is full opacity; all other bars render at 50% opacity. Below the chart, a session breakdown table shows: Session, Calls, Tokens, Cost per row.
Memory
The Memory view has two distinct data sources: Memories are explicit .md files with YAML frontmatter stored in the .monomind/memories/ directory. Chunks are indexed text segments extracted from project source files and documentation for semantic search.
| Memory Type | Color | Purpose |
|---|
user | Indigo | Personal preferences, identity, working style |
feedback | Amber | Agent routing decisions and confidence scores |
project | Teal | Project-scoped facts, patterns, decisions |
reference | Violet | Reference documentation, API facts |
handoff | Pink | Cross-session state for next session pickup |
Memories are created in three ways:
monomind memory store --key "preference" --value "..." --namespace user
The Memory view has 7 sub-tabs:
| Tab | Description |
|---|
| Memories | Split-pane list + detail editor. Full CRUD: create, edit (modal with type/title/content fields), delete. New Memory button offers 4 type templates: user (personal preferences/identity), feedback (routing decisions), project (project-scoped facts), reference (documentation/API facts). Each pre-populates a minimal YAML front matter stub. |
| Routing | Routing feedback log — each entry shows agent chosen, confidence %, task description, and timestamp. YAML front matter stub format for new memories:
---
name: my preference
description: Short description of this memory
type: user
---
Content body here... |
| Usage | Period tabs + stat grid (cost, calls, tokens, cache efficiency) + 5 bar charts: Models, Activity by hour, Tools, MCP Servers, Projects |
| ADRs | Architecture Decision Records as filterable cards. Status badges: Accepted, Proposed, Deprecated. Category filters: implementation, guidance |
| Swarm | Swarm run list + canvas topology visualization — static snapshot drawing, drawn once when a run is selected. Hierarchical: queen node (labeled Q, teal, larger) at top, worker nodes spread below, straight edges connecting them. Mesh/other: nodes in a circle with all-to-all edges. Event log for selected run. Clean Data button purges stale run data |
| Chunks | Stats bar (chunk count, skill namespaces, total namespaces). Filter by namespace or keyword. Chunk cards show source file, excerpt, and namespace. Edit/Delete per card. Build Docs button triggers indexing with progress polling |
| Agent Graph | Summary stat cards, session list, agent spawn bar chart (agents per session), tool usage bar chart (calls per tool across all sessions) |
Routing tab: Routing data is collected automatically whenever Claude Code routes a task to an agent. No setup required. Use /hooks:overview to understand the routing hook.
ADRs tab: ADRs are created via the slash command or discovered automatically from existing ADR files:
/monomind:adr
Swarm tab: Swarm history is created when you run agent organizations:
/mastermind:createorg
/mastermind:runorg
Chunks tab: Chunks are built by indexing your project's documentation and skill files:
/monomind:understand
monomind daemon start
Agent Graph tab: The Agent Graph is populated automatically by sessions that spawn sub-agents. Spawn agents by running complex tasks via /mastermind:build, /mastermind:autodev, or any orchestration command.
Orgs
Create and manage agent organizations:
/mastermind:createorg
/mastermind:runorg
Organizations are multi-agent structures with roles, goals, routines, and approval workflows. Each org card shows: a running dot (live indicator), name, goal description, topology/role chips, and an avatar stack of active agents.
Each org has 29 tabs:
| Tab | What it shows |
|---|
| Chart | Org hierarchy as an animated SVG — nodes for each role, animated edges for reporting lines |
| Roles | Role cards listing responsibilities, required skills, and reporting structure |
| Activity | Chronological event log of all agent actions within the org |
| Health | Metrics grid: task completion rate, error rate, average response time, agent uptime |
| Heartbeats | Per-agent heartbeat list showing last ping time and status (alive/stale/dead) |
| Tasks | Full task list with status, assignee, priority, and due date |
| Costs | Cost breakdown by agent, role, and time period with totals |
| Members | Human and agent member list with role assignments |
| Goals | Hierarchical goal tree with progress bars for each objective and sub-objective |
| Board | Kanban board with columns: Open, In Progress, Blocked, Done, Cancelled |
| Live | Real-time agent activity feed; auto-refreshes every 5 seconds. Shows currently running agents and their current task |
| Approvals | Approve/reject queue for actions that require human sign-off |
| Secrets | Secret names and scopes — values are always masked (never shown in plaintext) |
| Settings | Org configuration form that generates the equivalent CLI command for reproducibility |
| Routines | Cron table of scheduled automations: name, schedule expression, last run, next run, status |
| My Issues | Issues assigned to the current user or agent |
| Budgets | Fill bars showing spend vs. budget limit per agent and in aggregate |
| Plugins | Installed plugin status cards: name, version, enabled toggle, health indicator |
| Charts | 14-day activity heatmap + per-agent bar charts for calls and cost |
| Projects | Card grid of projects associated with this org |
| Skills | Role × skill matrix — cells show proficiency level (none/basic/expert) |
| Workspaces | Per-agent workspace rows: branch, working directory path, running services |
| Invites | Pending invitations with invite token, role, and expiry timestamp |
| Agents | Full agent table: name, type, status, model, last active, total calls, total cost |
| Environments | Agent environment configs: driver (node/python/docker), host, status |
| Access | Members grouped by role tier with their granted permissions listed |
| Issues | Full issue table (up to 100 rows): title, status, priority, assignee, labels, created date |
| Join Queue | Pending join requests showing requester (human 👤 or agent 🤖 emoji) and approval status |
| Threads | Discussion threads: subject, author, message count, linked issue |
Monograph
The knowledge graph must be built before Monograph tabs show data:
/monograph:monograph-build
monomind monograph build --code-only
The Monograph view provides a full knowledge-graph interface for your codebase. It has 7 tabs:
| Tab | Description |
|---|
| Overview | Stat cards (total nodes, total edges, average degree, type counts), top 6 nodes by degree, and a type-distribution breakdown |
| Graph | Interactive force-directed graph in an iframe. WATCH toggle enables file-system watching so the graph auto-rebuilds on file changes. REBUILD button forces a full rebuild immediately |
| Analyze | Two groups of analyses: 9 client-side (Stats, PageRank, Dead Code, Components, Topological Sort, Hubs, Cycles, Surprises, Communities) and 20 server-side MCP analyses (Health Score, Risk Profile, Hotspots, Maintainability, Complexity, CRAP Score, Instability, Coupling Balance, Circular Dependencies, Unlinked References, Dead Exports, Reachability, Boundary Check, Bridges, Cohesion, Largest Files, Languages, Churn Hotspots, Detect Changes, Authors) |
| Query | 6 query forms: Search nodes (BM25 keyword), Impact analysis (upstream/downstream dependents), Context (360° view of a file), Shortest path (between two nodes), Cypher query (raw graph query), Ask the graph (natural language) |
| Export | Download the graph in: JSON, SVG, GraphML, or Cypher format |
| Report | Rendered GRAPH_REPORT with summary stats, top nodes by degree, and type distribution |
| Wiki | Searchable node browser — type filter pills, mode toggle (All / Docs / Code), full-text search. Clicking a node opens a detail panel with Impact, Context, and Explain actions |
The Wiki tab shows code nodes immediately after a graph build. To also see documentation nodes (from .md/.mdx/.txt files), click BUILD DOCS inside the Wiki tab or run /monomind:understand.
Global Feed
A unified activity stream across all registered projects, accessible from the sidebar "⊕ Global Feed" item.
The Global Feed populates automatically as you use Claude Code across multiple projects. No setup required — add more projects via monomind init in each project directory.
Each event entry displays a project tag chip alongside the event data, so you can see which project generated each activity. The feed is assembled by fetching /api/projects and then merging session events from all project paths.
Unlike the Now view (which is scoped to one project), the Global Feed gives a workspace-wide perspective — useful for multi-project workflows and general activity monitoring.
Mastermind Overlay
The Mastermind overlay opens by clicking the violet ⬡ Mastermind button in the topbar. It has 6 tabs:
| Tab | Description |
|---|
| Orgs | List of all orgs — click to switch the dashboard's active org context |
| Skills | Searchable catalog of all 35+ slash-command skills. Click any skill to copy the /skill-name command to clipboard |
| Loops | Running loops with live countdown timers and Stop buttons — mirrors the Loops view in a compact panel. Create loops with /mastermind:autodev --tillend or the +New Loop button in the Loops view. |
| Create Org | Form that generates and copies the equivalent /mastermind:createorg CLI command when submitted |
| Metrics | Summary cards for current cost, API calls, routing confidence distribution, and active swarm topology |
| Graph | Node and edge counts for the Monograph index, list of top god nodes, and an Open Monograph button |
Command Palette ⌘K
Open with ⌘K or the Search button in the topbar. Results are grouped:
| Group | Contents |
|---|
| Sessions | Recent sessions — select to open that session in the Now view |
| Memory | Memory entries — select to open the memory detail editor |
| Projects | Registered projects — select to switch project context |
| Orgs | Organizations — select to switch to that org's view |
| Skills | Slash-command skills — select to copy the command |
| Actions | Quick actions: Open Monograph, Refresh, Toggle Compact, Open Loops |
| Tabs | Appears when an org is selected — lists all 29 org tabs for direct navigation |
Type a > prefix in the palette input to switch to cross-session full-text search mode — queries all session content, not just titles.
Keyboard Shortcuts
| Key | Action | Context |
|---|
⌘K | Open command palette | Global |
? | Show keyboard shortcuts help | Global |
R | Refresh current view | Global |
Esc | Close open panels or modals | Global |
J | Navigate down in list | Now, Sessions |
K | Navigate up in list | Now, Sessions |
↵ | Open detail panel / jump to session | Now, Sessions |
/ | Open feed search | Now |
G | Jump to live session (newest entry) | Now |
A | Toggle ambient mode | Now |
F | Toggle focus mode (full-width feed) | Now |
Space | Play / pause live tail | Now |
API Reference
All endpoints are served by the local dashboard server at localhost:4242. SSE endpoints stream newline-delimited JSON.
Navigation / Init
| Method | Endpoint | Description |
|---|
| GET | /api/git-user | Git username and email |
| GET | /api/projects | All registered projects |
| GET | /api/status | System health: HNSW, memory |
Sessions
| Method | Endpoint | Description |
|---|
| GET | /api/session-journal | Session metadata list |
| GET | /api/session | Events for one session file |
| GET (SSE) | /api/events-stream | Live tool event stream |
| GET | /api/search-sessions | Full-text session search |
| GET | /api/session-errors | Session error list |
| GET | /api/tool-errors | Tool error list per session |
| GET | /api/tool-ranking | Tool call frequency |
| GET | /api/project-costs | Per-project cost breakdown |
Memory
| Method | Endpoint | Description |
|---|
| GET | /api/section | Named data sections (e.g. tokens) |
| GET | /api/memory/stats | AgentDB stats |
| GET | /api/memory-files | .md file list |
| PUT / DELETE | /api/memory-file | Create or delete memory file |
| GET | /api/token-usage | Token usage, accepts period param |
| GET | /api/routing-feedback | Routing feedback log |
| GET | /api/adrs | Architecture Decision Records |
Loops
| Method | Endpoint | Description |
|---|
| GET | /api/loops | Active loops |
| POST | /api/loops/create | Create loop |
| GET | /api/loops/stop | Stop a loop |
Swarm
| Method | Endpoint | Description |
|---|
| GET | /api/swarm-history | Swarm run list |
| GET | /api/swarm-events | Events for a run |
| DELETE | /api/swarm-clean | Purge swarm data |
Knowledge (Chunks)
| Method | Endpoint | Description |
|---|
| GET | /api/section?name=knowledge | Indexed chunks |
| POST / DELETE | /api/knowledge-chunk | Chunk CRUD |
| POST | /api/monograph-build-docs | Trigger docs indexing |
| GET | /api/monograph-build-docs-status | Indexing progress |
Graph (Monograph)
| Method | Endpoint | Description |
|---|
| POST | /api/monograph-build | Rebuild graph |
| POST | /api/monograph-watch-toggle | Toggle file watch |
| GET | /api/monograph-watch-status | Watch state |
| GET | /api/monograph-graph | Graph nodes/edges |
| GET | /api/monograph-report | GRAPH_REPORT |
| GET | /api/monograph-query | BM25 node search |
| GET | /api/monograph-path | Shortest path between two nodes |
| GET | /api/monograph-explain | Node explanation |
| GET | /api/monograph-wiki-search | Wiki full-text search |
| GET | /api/graph | Agent graph data |
| POST | /api/mcp/call | MCP tool proxy |
Orgs
| Method | Endpoint | Description |
|---|
| GET | /api/orgs | Org list |
| GET | /api/org/:name | Org detail |
| POST | /api/orgs/:name/stop | Stop org |
| GET | /api/org/:name/activity | Org activity log |
| GET | /api/org/:name/health | Org health metrics |
| GET | /api/org/:name/agents | Org agents |
| GET | /api/org/:name/budgets | Org budgets |
| GET | /api/org/:name/members | Org members |
| GET | /api/org/:name/issues | Org issues |
| GET / POST | /api/org/:name/approvals | Approval queue |
| GET | /api/org/:name/secrets | Secret names and scopes |
| GET | /api/org/:name/routines | Scheduled routines |
| GET | /api/org/:name/my-issues | Issues assigned to current user |
| GET | /api/org/:name/plugins | Installed plugins |
| GET | /api/org/:name/projects | Associated projects |
| GET | /api/org/:name/workspaces | Agent workspaces |
| GET | /api/org/:name/invites | Pending invitations |
| GET | /api/org/:name/environments | Agent environment configs |
| GET | /api/org/:name/join-requests | Pending join requests |
| GET | /api/org/:name/threads | Discussion threads |
