Skip to content

Work Buddy

The AI assistant for knowledge workers — a local-first personal-agent runtime built on Claude Code and Obsidian.

Install

$git clone https://github.com/KadenMc/work-buddy

Install command taken from the project's README or registry entry. Always review code before running it.

work-buddy

Your AI doesn't understand how you actually operate. Meet <b>work-buddy</b>.

Website

Docs &bull;
Get Started &bull;
How It Works &bull;
Documentation &bull;
Community &bull;
Contributing

work-buddy is the AI assistant for knowledge workers — a local-first personal-agent runtime built on Claude Code and MCP that organizes the work around the work: journal entries, scattered tasks, open browser tabs, and the projects they belong to. It gives your agent structured multi-step workflows, memory that survives across sessions, deep integration with the tools your work already lives in, and a React dashboard that lends visibility and control.

Runs on your existing Claude Code subscription — no separate service fees. The agent you're already paying for does the work; your data stays on your machine.

<em>The dashboard's Chats tab: browsing and searching across agent sessions.</em>

Get Started

You'll need Claude Code (CLI or Desktop). Obsidian is an optional legacy compatibility integration; native Journal, Tasks, Projects, Contracts, Personal Knowledge, Calendar, and Co-work editing do not require it.

  1. Download the installer from the latest release and run it.
    • Bundles its own Python (about 1 GB of dependencies).
    • Windows today; macOS and Linux installers are coming soon!
  2. Open the install folder in Claude Code. work-buddy is already running, and Claude Code connects to it automatically.
  3. Run /wb-setup guided. An agent walks you through the rest of setup: which features you want, connected to your own tools and preferences.
  4. Start working. In Claude Code:
/wb-morning        # the morning routine: briefing, priorities, day plan
/wb-task-triage    # batch-decide on your task inbox
/wb-dev            # extend work-buddy itself

And from any terminal:

wbuddy status                    # sidecar health
wbuddy start | stop | restart    # control the background services
wbuddy launch                    # start if needed, then open the dashboard app
wbuddy --help                    # everything else

A system-tray icon shows work-buddy's status at a glance and opens a small panel to start, stop, or restart it and jump to the dashboard. The installer also adds a branded, console-free Start Menu launcher, with an optional Desktop shortcut. It starts or recovers the local runtime before opening the React app. The same dashboard at /app/ can optionally be installed from Chrome or Edge as a standalone PWA window.

What Can I Do with work-buddy?

Similar plugs

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local…

Why use many token when few token do trick. Viral skill + proxy for coding agents that cuts 65% of tokens by talking like a caveman.

Explore related