# ovid/claude-context architecture

> Architecture diagram of the GitHub repository ovid/claude-context, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ovid/claude-context
- Repository: https://github.com/ovid/claude-context

## Overview

claude-context is a Claude Code plugin that exposes context-window, usage, cost, and compaction facts to agents. The main workflow is: a statusline collector captures Claude Code’s stdin data into per-session snapshots; an agent invokes the report, which combines snapshot and transcript data into a human-readable summary and JSON. Setup/teardown wire and restore the statusline, including coexistence with an existing command. The graph reflects documented capabilities and shown imports/calls; unsampled command and skill internals are represented by their exact directories, with uncertain links omitted.

Main entry points: [`plugins/claude-context/scripts/collect.mjs`](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/collect.mjs) (Statusline collector), [`plugins/claude-context/scripts/report.mjs`](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/report.mjs) (Resource report), [`plugins/claude-context/scripts/wiring.mjs`](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/wiring.mjs) (Statusline wiring), [`plugins/claude-context/scripts/lib/command.mjs`](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/command.mjs) (Command builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and persistence"]
  node_collector["Statusline collector<br/>[collect.mjs]"]
  node_stdin["Statusline input<br/>[stdin.mjs]"]
  node_snapshots[("Snapshot store<br/>[snapshot.mjs]")]
end

subgraph group_reporting["Agent reporting"]
  node_skill["Report skill<br/>[SKILL.md]"]
  node_report["Resource report<br/>[report.mjs]"]
  node_transcript["Transcript analysis<br/>[transcript.mjs]"]
end

subgraph group_wiring["Statusline lifecycle"]
  node_setup["Setup command"]
  node_teardown["Teardown command"]
  node_wiring["Statusline wiring<br/>[wiring.mjs]"]
  node_coexist["Coexist wrapper<br/>[coexist.mjs]"]
  node_command["Command builder<br/>[command.mjs]"]
  node_marker["Ownership marker<br/>[marker.mjs]"]
  node_redact["Command redaction<br/>[redact.mjs]"]
end

subgraph group_internals["Shared runtime utilities"]
  node_atomic["Atomic file writes<br/>[atomic-write.mjs]"]
  node_config["Config paths<br/>[config-dir.mjs]"]
  node_tokenmath["Token calculations<br/>[token-math.mjs]"]
  node_time["Time utilities<br/>[time.mjs]"]
end

node_claude(("Claude Code"))
node_agent(("Agent"))

node_claude -->|"sends statusline data"| node_collector
node_collector -->|"reads input"| node_stdin
node_collector -->|"calculates usage"| node_tokenmath
node_collector -->|"normalizes resets"| node_time
node_collector -->|"resolves snapshot path"| node_config
node_collector -->|"writes snapshot"| node_snapshots
node_snapshots -->|"writes atomically"| node_atomic
node_agent -->|"requests report"| node_skill
node_skill -->|"runs report script"| node_report
node_report -->|"reads snapshots"| node_snapshots
node_report -->|"resolves session paths"| node_config
node_report -->|"reads usage and compactions"| node_transcript
node_report -->|"calculates context"| node_tokenmath
node_report -->|"formats reset times"| node_time
node_report -->|"returns summary and JSON"| node_agent
node_setup -->|"configures statusline"| node_wiring
node_teardown -->|"restores statusline"| node_wiring
node_wiring -->|"builds wrapper command"| node_command
node_wiring -->|"detects ownership"| node_marker
node_wiring -->|"previews commands"| node_redact
node_command -->|"creates marker"| node_marker
node_command -->|"launches collector variant"| node_collector
node_command -->|"launches coexist variant"| node_coexist
node_coexist -.->|"invokes collector"| node_collector
node_coexist -.->|"uses snapshot support"| node_snapshots
node_wiring -->|"resolves settings paths"| node_config
node_wiring -->|"persists settings"| node_atomic

click node_setup "https://github.com/ovid/claude-context/tree/main/plugins/claude-context/commands"
click node_teardown "https://github.com/ovid/claude-context/tree/main/plugins/claude-context/commands"
click node_wiring "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/wiring.mjs"
click node_coexist "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/coexist.mjs"
click node_command "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/command.mjs"
click node_marker "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/marker.mjs"
click node_redact "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/redact.mjs"
click node_collector "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/collect.mjs"
click node_stdin "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/stdin.mjs"
click node_snapshots "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/snapshot.mjs"
click node_atomic "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/atomic-write.mjs"
click node_config "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/config-dir.mjs"
click node_tokenmath "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/token-math.mjs"
click node_time "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/time.mjs"
click node_skill "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/SKILL.md"
click node_report "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/report.mjs"
click node_transcript "https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/transcript.mjs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_collector,node_stdin,node_snapshots toneBlue
class node_skill,node_report,node_transcript toneAmber
class node_setup,node_teardown,node_wiring,node_coexist,node_command,node_marker,node_redact toneMint
class node_atomic,node_config,node_tokenmath,node_time toneRose
class node_claude,node_agent toneIndigo
```

## Components

### Capture and persistence

- [Statusline collector](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/collect.mjs): `plugins/claude-context/scripts/collect.mjs`
- [Statusline input](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/stdin.mjs): `plugins/claude-context/scripts/lib/stdin.mjs`
- [Snapshot store](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/snapshot.mjs): `plugins/claude-context/scripts/lib/snapshot.mjs`

### Agent reporting

- [Report skill](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/SKILL.md): `plugins/claude-context/SKILL.md`
- [Resource report](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/report.mjs): `plugins/claude-context/scripts/report.mjs`
- [Transcript analysis](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/transcript.mjs): `plugins/claude-context/scripts/lib/transcript.mjs`

### Statusline lifecycle

- [Setup command](https://github.com/ovid/claude-context/tree/main/plugins/claude-context/commands): `plugins/claude-context/commands`
- [Teardown command](https://github.com/ovid/claude-context/tree/main/plugins/claude-context/commands): `plugins/claude-context/commands`
- [Statusline wiring](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/wiring.mjs): `plugins/claude-context/scripts/wiring.mjs`
- [Coexist wrapper](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/coexist.mjs): `plugins/claude-context/scripts/coexist.mjs`
- [Command builder](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/command.mjs): `plugins/claude-context/scripts/lib/command.mjs`
- [Ownership marker](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/marker.mjs): `plugins/claude-context/scripts/lib/marker.mjs`
- [Command redaction](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/redact.mjs): `plugins/claude-context/scripts/lib/redact.mjs`

### Shared runtime utilities

- [Atomic file writes](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/atomic-write.mjs): `plugins/claude-context/scripts/lib/atomic-write.mjs`
- [Config paths](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/config-dir.mjs): `plugins/claude-context/scripts/lib/config-dir.mjs`
- [Token calculations](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/token-math.mjs): `plugins/claude-context/scripts/lib/token-math.mjs`
- [Time utilities](https://github.com/ovid/claude-context/blob/main/plugins/claude-context/scripts/lib/time.mjs): `plugins/claude-context/scripts/lib/time.mjs`

### Other components

- **Claude Code**
- **Agent**

## Connections

- Claude Code → Statusline collector: sends statusline data (evidence: `README.md`)
- Statusline collector → Statusline input: reads input (evidence: `plugins/claude-context/scripts/collect.mjs`)
- Statusline collector → Token calculations: calculates usage (evidence: `plugins/claude-context/scripts/collect.mjs`)
- Statusline collector → Time utilities: normalizes resets (evidence: `plugins/claude-context/scripts/collect.mjs`)
- Statusline collector → Config paths: resolves snapshot path (evidence: `plugins/claude-context/scripts/collect.mjs`)
- Statusline collector → Snapshot store: writes snapshot (evidence: `plugins/claude-context/scripts/collect.mjs`)
- Snapshot store → Atomic file writes: writes atomically (evidence: `plugins/claude-context/scripts/lib/snapshot.mjs`)
- Agent → Report skill: requests report (evidence: `README.md`)
- Report skill → Resource report: runs report script (evidence: `README.md`)
- Resource report → Snapshot store: reads snapshots (evidence: `plugins/claude-context/scripts/report.mjs`)
- Resource report → Config paths: resolves session paths (evidence: `plugins/claude-context/scripts/report.mjs`)
- Resource report → Transcript analysis: reads usage and compactions (evidence: `plugins/claude-context/scripts/report.mjs`)
- Resource report → Token calculations: calculates context (evidence: `plugins/claude-context/scripts/report.mjs`)
- Resource report → Time utilities: formats reset times (evidence: `plugins/claude-context/scripts/report.mjs`)
- Resource report → Agent: returns summary and JSON (evidence: `README.md`)
- Setup command → Statusline wiring: configures statusline (evidence: `README.md`)
- Teardown command → Statusline wiring: restores statusline (evidence: `README.md`)
- Statusline wiring → Command builder: builds wrapper command (evidence: `plugins/claude-context/scripts/wiring.mjs`)
- Statusline wiring → Ownership marker: detects ownership (evidence: `plugins/claude-context/scripts/wiring.mjs`)
- Statusline wiring → Command redaction: previews commands (evidence: `plugins/claude-context/scripts/wiring.mjs`)
- Command builder → Ownership marker: creates marker (evidence: `plugins/claude-context/scripts/lib/command.mjs`)
- Command builder → Statusline collector: launches collector variant (evidence: `plugins/claude-context/scripts/lib/command.mjs`)
- Command builder → Coexist wrapper: launches coexist variant (evidence: `plugins/claude-context/scripts/lib/command.mjs`)
- Coexist wrapper → Statusline collector: invokes collector (evidence: `plugins/claude-context/scripts/coexist.mjs`)
- Coexist wrapper → Snapshot store: uses snapshot support (evidence: `plugins/claude-context/scripts/coexist.mjs`)
- Statusline wiring → Config paths: resolves settings paths (evidence: `plugins/claude-context/scripts/wiring.mjs`)
- Statusline wiring → Atomic file writes: persists settings (evidence: `plugins/claude-context/scripts/wiring.mjs`)
