LOCAL-FIRST DATA LAYER FOR AGENT SESSIONS
Masthead imports and organizes session history across harnesses, shows what is happening now, stores what happened before, and makes that context available to any agent through MCP.
session library
Manual refresh stayed disabled because /api/settings returned the stale integration gate.
Search now returns titles, outcomes, source paths, and confidence labels for agent retrieval.
Codex adapter moved to Alpha; Claude Code, Hermes, and OpenClaw remain planned adapters.
retrieval result
Find prior sessions that explain OAuth callback state handling.
Pip / OAuth callback hardening captured the redirect-state guard, test command, changed files, and the unresolved production setting dependency.
active sessions
Tracing callback state handling and tightening redirect evidence before the next auth test.
Paused after normalizing OpenClaw event envelopes into the session compiler.
Deploy check found a missing environment alias before publishing the client surface.
Prepared a policy diff and human-readable findings for the operator write path.
4 runtimes observed • local SQLite index • MCP ready
Board / Logbook / MCP
See live work, recover past decisions, and let agents retrieve useful history without switching harnesses.
live operator board
Watch active sessions across harnesses in a quiet operator board with plain-English summaries and evidence-rich status cards.
active sessions
Tracing callback state handling and tightening redirect evidence before the next auth test.
Paused after normalizing OpenClaw event envelopes into the session compiler.
Deploy check found a missing environment alias before publishing the client surface.
Prepared a policy diff and human-readable findings for the operator write path.
searchable session library
session library
Manual refresh stayed disabled because /api/settings returned the stale integration gate.
Search now returns titles, outcomes, source paths, and confidence labels for agent retrieval.
Codex adapter moved to Alpha; Claude Code, Hermes, and OpenClaw remain planned adapters.
agent context access
retrieval result
Find prior sessions that explain OAuth callback state handling.
Pip / OAuth callback hardening captured the redirect-state guard, test command, changed files, and the unresolved production setting dependency.
Why Masthead exists
Every coding-agent session contains decisions, tool calls, failures, and project history. Most of that context stays trapped inside separate harnesses and gets lost the moment you stop looking at it.
JSONL session archive
742 example local archive recordslocal run journal
186 example local archive recordsconversation store
48 example local archive recordsevent transcript
31 example local archive recordsHow it works
Masthead finds supported runtimes and existing session history.
~/.codex/sessionsDifferent harness formats become one consistent session record.
session_graphA lightweight model generates useful titles, summaries, topics, and search projections.
summary + topicsSessions become searchable in Logbook.
SQLite FTSAny MCP-compatible agent can retrieve relevant session history.
MCP resourceHarness-neutral
Masthead is designed around the reality that session data lives across different runtimes and storage patterns. It normalizes the strongest local-first harnesses first and grows through graded adapters.
~/.codex/sessions/*.jsonlAlphalocal conversation storePlannedlocal run journalPlannedevent transcript archiveResearchcandidate CLI logsResearchPrivacy boundaries
Masthead is designed to collect and index session data locally. You choose which sources are included, how enrichment runs, and what connected agents can retrieve.
Session records stay on the machine when every configured part is local.
Only enrichment requests you configure are sent to the provider you choose.
MCP retrieval uses the local session library, then shares selected context with the agent you choose.
Use the product
Use Masthead on GitHub and start building a searchable, local-first memory layer for your agent sessions.
Use Mastheadgithub.com/MayberryDT/Masthead