## How it runs
Context flows in from everywhere you work. It comes back out wherever an agent asks.
-
1 · Feed
Everything you touch becomes context.
Meetings capture themselves — a macOS daemon notices your mic go live and transcribes both sides as
MeandThem, no bot in the call. Drop in links, files, and notes. Create tasks. Agents save repo gotchas as they hit them. -
2 · Orchestrate
One local index over all of it.
context-orchestrator keeps tasks and sources in SQLite and every sentence — transcripts, notes, repo knowledge — in a local vector index, searchable by meaning. Plain files on your disk. No cloud sync, no account.
-
3 · Recall
Any agent picks up where you left off.
Over MCP, an agent loads a task's full manifest or asks “what did we decide about pricing?” and gets the answer with the meeting and timestamp it came from. That's the torch: context carried from every past session into the current one.
Most of what an agent needs already happened —
in a conversation, a doc, a lesson learned.
contorch just keeps it.
## Install
One command stands up the whole stack. Re-run it anytime; it's idempotent.
1 · Bootstrap
$ curl -fsSL contorch.com/install | bash
Installs the context-orchestrator MCP server, the meeting-capture daemon, a menu-bar monitor, and the Claude Code auto-context hook. Missing prerequisites arrive via Homebrew.
2 · Click what macOS asks you to
Two permissions for meeting capture: Screen & System Audio
Recording and Microphone. The script ends with a
punch-list, and doctor commands verify every piece.
$ transcript-watcher doctor
✓ all checks passed
3 · Optional: Gemini key
Meeting transcription runs on Gemini — a free key from aistudio.google.com/apikey, about $0.0002 per meeting-minute beyond the free tier. Skip it and everything else stays fully local: tasks, sources, search, clipboard transcripts.
Then restart Claude Code and just work.
- Local-first. SQLite and a local vector index on your disk. No cloud sync, no account. Meeting audio goes to Gemini for transcription only, then gets deleted.
- Open source. Apache-2.0, on GitHub. Read every line that can hear you.
- Your agents, not ours. Standard MCP — Claude Code today; anything that speaks the protocol tomorrow.
- Plain files. Transcripts are Markdown in
~/transcripts— yours to grep, edit, or delete.