🧠the-brain

AI Tools

Configure AI tools to work with the-brain

the-brain auto-discovers interactions from these tools. For non-IDE sources (chat interfaces, web apps), write a custom harvester extension.

Cursor IDE

No configuration needed. the-brain reads SQLite logs from ~/.cursor/.

Supported formats:

  • v2: workspaceStorage/*/state.vscdb (SQLite)
  • v3: agent-transcripts/*.jsonl (JSONL)
  • AI tracking: ai-tracking/*.db (SQLite)

Claude Code

the-brain reads .claude/history.jsonl from your project root.

Project detection: Uses cwd from .claude/settings.json to match against registered contexts.

Gemini

Reads ~/.gemini/logs.json. Conversation history extracted from content.blocks.

Hermes Agent

Reads ~/.hermes/state.db (Hermes Agent's SQLite database). Pairs user↔assistant messages from sessions + messages tables. Tracks lastId offset for incremental harvesting.

lm-eval

Reads ~/.the-brain/eval-results/*.json. Harvests lm-evaluation-harness benchmark results. Computes per-model per-benchmark fingerprints with anomaly detection (>2σ). Enables meta-harness integration.

Adding a New Source

See Harvesters for writing your own harvester plugin. works for any data format — SQLite, JSONL, JSON, CSV, or API endpoints.

On this page