What is OpenPaw?

Claude Code is powerful, but out of the box it only knows how to code. OpenPaw turns it into a full personal assistant — one that reads your email, plays your music, controls your lights, manages your calendar, tracks your packages, and remembers what you told it last week.

Run one command and OpenPaw:

• Installs 38 skills across email, calendar, Spotify, smart home, Slack, GitHub, Obsidian, and more
• Sets up the CLI tools each skill needs (via Homebrew, npm, or pip) and walks you through auth
• Gives Claude an identity — a name, personality, and persistent memory across sessions
• Configures permissions and safety hooks so Claude can act autonomously without doing anything dangerous
• Adds a Telegram bridge so you can talk to Claude from your phone
• Includes a task dashboard — a local kanban board with drag-and-drop and 3 themes
• Enables smart scheduling — recurring tasks with per-run and daily cost caps so nothing runs away
• Can paw-style Claude Code itself — branded colors, spinners, input highlighting, and chat styling via openpaw theme

After setup, you just talk to Claude:

"Check my email and summarize anything urgent"
"Play lo-fi beats on Spotify"
"Turn the bedroom lights to 20%"
"What's on my calendar tomorrow?"
"Add milk to my reminders"
"Go to Hacker News and summarize the top 5 posts"

Claude figures out which skill to use. No special syntax needed.

No daemon, no cloud, no subscriptions. OpenPaw runs once, writes config, and gets out of the way. Everything runs locally through your existing Claude Code subscription.

Quick Start

npx pawmode

The wizard walks you through picking skills, choosing your interface (terminal, Telegram, or both), setting up a task dashboard, and authenticating with services. Or skip the wizard entirely:

npx pawmode --preset essentials       # common skills, no prompts
npx pawmode --preset developer --yes  # fully non-interactive

Skills

38 skills across 8 categories. Install only what you need.

Productivity

| Skill | What it does | Tools | |---|---|---| | c-notes | Apple Notes + Reminders | memo, remindctl | | c-obsidian | Obsidian vault management | obsidian-cli | | c-notion | Notion pages + databases | notion-cli | | c-tasks | Todoist / Taskwarrior | todoist, taskwarrior |

Communication

| Skill | What it does | Tools | |---|---|---| | c-email | Gmail or IMAP — read, send, search | gog, himalaya | | c-calendar | Google Calendar + Apple Calendar | gog, icalBuddy | | c-messaging | iMessage + WhatsApp | imsg, wacli | | c-slack | Slack channels + DMs | slack-cli | | c-telegram | Telegram bridge (built-in) | — |

Media

| Skill | What it does | Tools | |---|---|---| | c-music | Spotify playback + search | spogo | | c-video | YouTube download + convert | yt-dlp, ffmpeg | | c-video-edit | Programmatic video creation | remotion | | c-screen | Screenshots, OCR, webcam | peekaboo, camsnap | | c-voice | Speech-to-text + TTS | sag |

Smart Home

| Skill | What it does | Tools | |---|---|---| | c-lights | Philips Hue control | openhue-cli | | c-speakers | Sonos speakers | sonoscli | | c-bluetooth | Bluetooth devices | blucli |

Browser & Automation

| Skill | What it does | Tools | |---|---|---| | c-browser | Headless browser — navigate, click, scrape | playwright | | c-cron | Cron jobs + launchctl services | lunchy-go | | c-schedule | Recurring tasks with cost control | built-in | | c-briefing | Daily morning briefing | depends on email + calendar |

System & Files

| Skill | What it does | Tools | |---|---|---| | c-system | Volume, wifi, battery, dock | m-cli | | c-apps | Mac App Store from CLI | mas | | c-files | Cloud sync (Drive, S3, Dropbox, 70+) | rclone | | c-display | Brightness + safe trash | brightness, macos-trash | | c-notify | Native macOS notifications | terminal-notifier | | c-clipboard | Copy, paste, transform clipboard | built-in | | c-contacts | Search macOS Contacts | built-in | | c-timer | Countdown, alarms, pomodoro | terminal-notifier |

Research & Utilities

| Skill | What it does | Tools | |---|---|---| | c-weather | Weather forecasts | built-in (curl + wttr.in) | | c-research | Summarize URLs, PDFs, videos | summarize | | c-location | Apple Maps + nearby places | goplaces | | c-tracking | Package tracking (UPS, FedEx, etc.) | ordercli | | c-secrets | 1Password / Bitwarden | op, bw | | c-network | DNS + HTTP client | doggo, httpie |

Developer

| Skill | What it does | Tools | |---|---|---| | c-github | PRs, issues, repos, actions | gh, jq | | c-linear | Linear issues + projects | linear | | c-jira | Jira issues + sprints | jira-cli |

Presets

| Preset | Skills | |---|---| | Everything | All 38 skills | | Essentials | Email, calendar, notes, music, weather, clipboard, browser, system, notifications | | Productivity | Notes, Obsidian, tasks, email, calendar, Slack, cloud files, notifications | | Developer | GitHub, Linear, Jira, browser, network, cron | | Creative | Music, video, screen, voice, browser, research | | Smart Home | Lights, speakers, Bluetooth, system, display, notifications |

Features

Telegram Bridge — Talk to Claude from your phone. OpenPaw configures the official Claude Code Telegram plugin (telegram@claude-plugins-official) — the bridge runs inside Claude Code with the same model, skills, and permissions as your terminal, so there's no separate bot process to drift or crash. Set up with openpaw telegram setup, start with openpaw telegram.

Task Dashboard — Local kanban board with 3 themes (Paw, Midnight, Neon). Run openpaw dashboard.

Self-Learning — Opt in during setup and paw quietly gets better over time. After each session a Stop hook runs a cheap heuristic gate (≥5 tool calls, an error it recovered from, or a correction you made); only then does it spend one small claude -p call to distill a single durable takeaway into a learnings file. You choose where that lives during setup — plain markdown (~/.claude/memory/learnings.md, zero setup), an Obsidian vault, or any custom path — so it doesn't have to be Obsidian. Never stores secrets or full transcripts. Turn it off anytime with export OPENPAW_SELF_LEARNING=off.

Token Saving — Opt in and OpenPaw wires up rtk (Rust Token Killer) as a PreToolUse hook that compresses verbose command output — git status/diff, build logs, etc. — for 40–90% fewer tokens. Offered in the wizard; installs via Homebrew if you don't have it.

Migrate from another assistant — Already using Hermes, OpenClaw, Copilot, or Claude Code? openpaw migrate imports what they already know — facts from Hermes ~/.hermes/memories, OpenClaw's memory store, and your Claude Code history — into paw's self-learning memory, and can seed your SOUL.md from an existing persona. Secrets are stripped on the way in. Preview first with openpaw migrate --dry-run. The setup wizard offers this automatically when it detects another assistant on your machine.

Scheduling — Recurring tasks with per-run and daily cost caps. openpaw schedule add "weekdays 8am" --run "check email".

Claude Code Paw Theme — Patch Claude Code with OpenPaw styling using tweakcc plus a native mascot fallback patch. Run openpaw theme install and then openpaw theme verify, or opt into it during openpaw setup. If your Claude Code build accepts custom themes, switch inside Claude Code with /theme openpaw; otherwise you still get the Paw mascot, welcome copy, mascot colors, lock-in status line, spinner, and input styling.

CLAUDE.md Integration — OpenPaw writes a section into ~/.claude/CLAUDE.md so Claude knows its name, installed skills, and personality on every session start. Your existing CLAUDE.md content is preserved.

Commands

| Command | Description | |---|---| | openpaw | Interactive setup wizard | | openpaw configure | Menu to add skills, edit personality, manage dashboard | | openpaw add <skills> | Add skills — openpaw add notes music email | | openpaw remove <skills> | Remove skills | | openpaw list | Show all available skills | | openpaw status | Show installed skills + tool versions | | openpaw doctor | Diagnose issues | | openpaw update | Upgrade CLI tools | | openpaw dashboard | Task dashboard (--theme midnight, --port 8080) | | openpaw theme install | Install the OpenPaw Claude Code patch globally | | openpaw theme verify | Verify that Claude Code contains OpenPaw mascot/theme markers | | openpaw telegram | Start Telegram bridge | | openpaw schedule add | Add a scheduled job | | openpaw schedule list | List scheduled jobs | | openpaw schedule costs | View cost usage | | openpaw soul | Edit personality | | openpaw migrate | Import knowledge from Hermes/OpenClaw/Copilot/Claude Code (--dry-run, --from) | | openpaw export / import | Backup and restore config | | openpaw reset | Remove everything OpenPaw installed |

Contributing

gh repo fork daxaur/openpaw
mkdir skills/c-yourskill
# Write a SKILL.md with YAML frontmatter (name, description, tags)
# Add tool definitions to src/catalog/index.ts
gh pr create

License

MIT — @daxaur