internal/

Package board assembles the data model one frame shows: discovered agents enriched from their session files, plus the secondary sections.

Package config inventories the agent-config files that shape behaviour for a project: instruction files, rules, hooks, and commands — across all supported harnesses — in one place.

Package ctxstack reports the effective instruction stack for a session: what is (or would be) loaded for a given cwd — the memory-file chain, hooks, and configured MCP servers — each with an estimated token cost, plus the live window/context figures and the session's compaction events.

Package drift detects mismatches between what agent sessions repeatedly ask for and what committed config files say.

Package du is disk triage for the files the agent CLIs accumulate: a size breakdown by category, largest first, with a one-line explanation of what each is and whether deleting it is safe.

Package eventlog records structural observations about live agent sessions to an append-only, size-capped NDJSON file.

Package filehist renders the change history of a single instruction file (a CLAUDE.md / AGENTS.md / rule file): a git-log timeline when the file is tracked, or agentdash's own hash/size snapshots when it isn't, with each change attributed to the agent session that made it (or to no recorded session) by correlating the change time against Edit/Write tool calls in the transcripts.

Package grep is a structured full-text search across the transcripts both agents already write (Claude Code's ~/.claude/projects/**/*.jsonl and Codex's ~/.codex/sessions/**/*.jsonl).

Package health is a one-screen roll-up of per-agent warning signals, so a glance (or a cron job) can tell whether any live session needs attention.

Package hermesdb is an optional, read-only adapter for the Hermes agent's SQLite session store.

Package history samples past agent conversations from the transcript files the agent CLIs already write.

Package jsonout serializes the board as --json schema_version 1, a frozen contract: field-for-field identical to v1.

Package memory is agentdash's local agent-memory sampler.

Package parse is the Go port of the embedded Python engine from the v1 bash script (legacy/agentdash.sh): it locates and folds agent session JSONL into per-session entries, incrementally by byte offset.

Package procs reads agent processes and system state from the OS.

Package trail reconstructs, from transcripts only, what agents actually did on this box: the commands they ran, the files they wrote, and any secrets that ended up in the conversation.

Package ui is the interactive watch mode: a small raw-terminal loop over the shared board collector and table renderer.

Package usage estimates token spend locally from the per-message usage blocks the agent CLIs already write — no credentials, no provider API, no network.