Work Buddy¶
Personal agent framework built on Claude Code and MCP. Orchestrates tasks, manages workflows, coordinates across projects — so you can focus on your actual work.
What is work-buddy?¶
work-buddy is a personal agent framework built on Claude Code and Obsidian which orchestrates tasks, manages workflows, coordinates across projects — so you can focus on your actual work. It gives your AI agent structured multi-step workflows, memory that survives across sessions, deep integration with external tooling, and a dashboard that empowers you directly!
It runs locally, uses your own API keys, and stores everything on your machine.
Documentation¶
Getting Started¶
- README — Quick start, installation, and feature overview
- Setup Guide — Detailed configuration walkthrough
- Contributing — How to extend work-buddy
Reference¶
- Knowledge Handbook — Auto-generated reference for all 207 agent-facing units: directions, system docs, capabilities, and workflows
- CLAUDE.md — Agent orientation and MCP gateway reference
- Changelog — Release history
Key Concepts¶
| Concept | Description |
|---|---|
| Capabilities | Single functions exposed through the MCP gateway. Discoverable via wb_search, executable via wb_run. |
| Workflows | Multi-step DAGs with dependency ordering, auto-run steps, and persistent state. |
| Knowledge Store | Typed JSON registry with hierarchical navigation. Agents query it at runtime. |
| Consent System | Session-scoped grants with multi-surface delivery (Obsidian, Telegram, Dashboard). |
| Sidecar | Background supervisor managing services, scheduled jobs, and retry queues. |