leap-ops-stack

# leap-ops-stack > Vault + MCP + transcription + Cowork, wired up. The same ops stack we install for paying [Leap Agentic](https://leapagentic.io) clients, open-sourced so you can run it yourself. > > **Install in one sitting (~2 hours). Scaffolds the knowledge system and meeting pipeline a team needs before any AI-delivery work begins.** ## TL;DR Three connected pieces running on your own machine: 1. **Shared Obsidian vault** — markdown files, synced across the team via iCloud/Dropbox/Syncthing. Portable, plain-text, no vendor lock-in. 2. **MCP server on top of the vault** — exposes it to Claude Code, Claude Cowork, Cursor, and any MCP-capable agent. Search, read, write, patch, tag — all conversational. 3. **Meeting capture → transcription → vault** — OBS records locally, Deepgram transcribes, Claude maps speakers using your team file, markdown lands in the vault. What you get: every finding, decision, transcript, and client note in one searchable markdown store that every AI agent on the team can read and write. ## Why this repo exists Most teams run their knowledge in six places: Notion, Slack, Google Drive, Figma, Linear, a shared inbox. Agents can't read that. A LEAP-delivery flow requires the team's context to live somewhere an agent can work with — and that has to be a format the team already trusts. A vault of markdown files on disk, exposed via MCP, is the minimum viable knowledge base for an agent-first team. ## Who it's for - **Engineering teams** who want Claude Code to see their docs, meetings, and decisions while they work. - **Ops-heavy founders** who want Cowork to summarize calls, triage inbox, draft docs from natural language. - **Leap Agentic clients** — this is what we install in the Ops Setup engagement. Everything is open-source so you can DIY, hire us to install, or hybrid. ## What's in this repo | Path | Purpose | |------|---------| | [`setup.md`](./setup.md) | Step-by-step install flow, ~2 hours | | [`configs/claude_desktop_config.example.json`](./configs/claude_desktop_config.example.json) | Cowork MCP config with `autoapprove` | | [`configs/mcp.example.json`](./configs/mcp.example.json) | Claude Code `.mcp.json` template | | [`configs/gitignore.example`](./configs/gitignore.example) | Starter `.gitignore` for the vault | | [`templates/HOME.md`](./templates/HOME.md) | Vault dashboard template | | [`templates/project-instructions.md`](./templates/project-instructions.md) | Cowork project boilerplate prompt | | [`templates/team-context.md`](./templates/team-context.md) | Team roster for speaker-ID + agent context | | [`templates/stack-context.md`](./templates/stack-context.md) | Tech stack briefing template | | [`playbooks/weekly-review.md`](./playbooks/weekly-review.md) | How to run a weekly review off the vault | | [`playbooks/meeting-intake.md`](./playbooks/meeting-intake.md) | Recording → transcript → summary flow | | [`playbooks/task-triage.md`](./playbooks/task-triage.md) | L1–L4 backlog triage pattern | | [`scripts/install.sh`](./scripts/install.sh) | Scaffold a new vault in one command | ## The stack | Layer | Default | Notes | |------------------------|-----------------------------------------------------------------------------------|-------------------------------------------------------| | Knowledge store | Obsidian vault (folder of markdown) | Works without Obsidian — the app is a nice editor | | Sync | iCloud Drive | Swap for Syncthing / Dropbox / git | | MCP server | [`@bitbonsai/mcpvault`](https://www.npmjs.com/package/@bitbonsai/mcpvault) | Open-source, ~15 vault tools over stdio | | AI surfaces | Claude Code (devs) + Claude Cowork (ops) + Claude mobile (travelers) | Same MCP, three front doors | | Transcription | Deepgram | Swap for AssemblyAI or local Whisper | | Recording | OBS Studio + Loopback (paid) or BlackHole (free) | Local-only, no bot joins calls | | Transcription pipeline | [`safitudo/meeting-transcriber`](https://github.com/safitudo/meeting-transcriber) | Docker, watches a folder, drops markdown in the vault | ## Quick start ```bash git clone https://github.com/safitudo/leap-ops-stack.git cd leap-ops-stack # Scaffold a vault ./scripts/install.sh --name my-team-vault --path "$HOME/Library/Mobile Documents/com~apple~CloudDocs" # Read setup.md for the rest — MCP config, OBS, transcription pipeline ``` See [`setup.md`](./setup.md) for the full walkthrough. ## License [MIT](./LICENSE). Fork it, run it, install it for clients, charge for installation. The value is the method + the implementation labor, not the prompts. ## Part of the LEAP toolkit - [safitudo/leap](https://github.com/safitudo/leap) — the framework hub - [safitudo/leap-audit](https://github.com/safitudo/leap-audit) — $500 audit, open source - [safitudo/leap-skill](https://github.com/safitudo/leap-skill) — Claude Code plugin - [safitudo/semver-leap](https://github.com/safitudo/semver-leap) — flagship proof - [safitudo/meeting-transcriber](https://github.com/safitudo/meeting-transcriber) — recording pipeline ## Paid install $5k flat, done in one session, scaled to your team afterwards. [leapagentic.io](https://leapagentic.io#how).