daxaur/openpaw

# GitHub Repository: daxaur/openpaw

**URL:** https://github.com/daxaur/openpaw
**Author:** daxaur
**Description:** Personal Assistant Wizard for Claude Code — npx pawmode
**Homepage:** https://www.npmjs.com/package/pawmode
**Language:** TypeScript

## Stats
- Stars: 152
- Forks: 7
- Open Issues: 0
- Commits: 126
- Created: 2026-02-28T15:05:56Z
- Updated: 2026-06-18T12:37:48Z
- Pushed: 2026-05-23T21:21:42Z

## README
<h1 align="center">OpenPaw</h1>
<p align="center"><b>Turn Claude Code into a personal assistant.</b></p>

<p align="center">
  <a href="https://www.npmjs.com/package/pawmode"><img src="https://img.shields.io/npm/v/pawmode?color=b4783c&label=npm&style=flat-square" alt="npm"></a>
  <a href="https://github.com/daxaur/openpaw/blob/main/LICENSE"><img src="https://img.shields.io/github/license/daxaur/openpaw?color=c88a48&style=flat-square" alt="license"></a>
  <a href="https://github.com/daxaur/openpaw"><img src="https://img.shields.io/github/stars/daxaur/openpaw?color=dca03c&style=flat-square" alt="stars"></a>
  <img src="https://img.shields.io/node/v/pawmode?color=8a5a2a&style=flat-square" alt="node">
</p>

<p align="center">
  <img src="docs/demo.gif" alt="OpenPaw Setup Demo" width="700">
</p>

---

## What is OpenPaw?

[Claude Code](https://docs.anthropic.com/en/docs/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

```bash
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:

```bash
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`](https://github.com/antoniorodr/memo), `remindctl` |
| `c-obsidian` | Obsidian vault management | [`obsidian-cli`](https://github.com/yakitrak/obsidian-cli) |
| `c-notion` | Notion pages + databases | [`notion-cli`](https://github.com/litencatt/notion-cli) |
| `c-tasks` | Todoist / Taskwarrior | [`todoist`](https://github.com/sachaos/todoist), [`taskwarrior`](https://github.com/GothenburgBitFactory/taskwarrior) |

### Communication

| Skill | What it does | Tools |
|---|---|---|
| `c-email` | Gmail or IMAP — read, send, search | `gog`, [`himalaya`](https://github.com/pimalaya/himalaya) |
| `c-calendar` | Google Calendar + Apple Calendar | `gog`, [`icalBuddy`](https://hasseg.org/icalBuddy/) |
| `c-messaging` | iMessage + WhatsApp | [`imsg`](https://github.com/steipete/imsg), `wacli` |
| `c-slack` | Slack channels + DMs | [`slack-cli`](https://github.com/rockymadden/slack-cli) |
| `c-telegram` | Telegram bridge (built-in) | — |

### Media

| Skill | What it does | Tools |
|---|---|---|
| `c-music` | Spotify playback + search | [`spogo`](https://github.com/steipete/spogo) |
| `c-video` | YouTube download + convert | [`yt-dlp`](https://github.com/yt-dlp/yt-dlp), [`ffmpeg`](https://ffmpeg.org/) |
| `c-video-edit` | Programmatic video creation | [`remotion`](https://github.com/remotion-dev/remotion) |
| `c-screen` | Screenshots, OCR, webcam | [`peekaboo`](https://github.com/steipete/peekaboo), `camsnap` |
| `c-voice` | Speech-to-text + TTS | [`sag`](https://github.com/steipete/sag) |

### Smart Home

| Skill | What it does | Tools |
|---|---|---|
| `c-lights` | Philips Hue control | [`openhue-cli`](https://github.com/openhue/openhue-cli) |
| `c-speakers` | Sonos speakers | [`sonoscli`](https://github.com/steipete/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`](https://github.com/rgcr/m-cli) |
| `c-apps` | Mac App Store from CLI | [`mas`](https://github.com/mas-cli/mas) |
| `c-files` | Cloud sync (Drive, S3, Dropbox, 70+) | [`rclone`](https://github.com/rclone/rclone) |
| `c-display` | Brightness + safe trash | [`brightness`](https://github.com/nriley/brightness), [`macos-trash`](https://github.com/sindresorhus/macos-trash) |
| `c-notify` | Native macOS notifications | [`terminal-notifier`](https://github.com/julienXX/terminal-notifier) |
| `c-clipboard` | Copy, paste, transform clipboard | built-in |
| `c-contacts` | Search macOS Contacts | built-in |
| `c-timer` | Countdown, alarms, pomodoro | [`terminal-notifier`](https://github.com/julienXX/terminal-notifier) |

### Research & Utilities

| Skill | What it does | Tools |
|---|---|---|
| `c-weather` | Weather forecasts | built-in (curl + [wttr.in](https://wttr.in)) |
| `c-research` | Summarize URLs, PDFs, videos | [`summarize`](https://github.com/steipete/summarize) |
| `c-location` | Apple Maps + nearby places | [`goplaces`](https://github.com/steipete/goplaces) |
| `c-tracking` | Package tracking (UPS, FedEx, etc.) | [`ordercli`](https://github.com/steipete/ordercli) |
| `c-secrets` | 1Password / Bitwarden | [`op`](https://developer.1password.com/docs/cli/), [`bw`](https://github.com/bitwarden/clients) |
| `c-network` | DNS + HTTP client | [`doggo`](https://github.com/mr-karan/doggo), [`httpie`](https://github.com/httpie/cli) |

### Developer

| Skill | What it does | Tools |
|---|---|---|
| `c-github` | PRs, issues, repos, actions | [`gh`](https://github.com/cli/cli), [`jq`](https://github.com/jqlang/jq) |
| `c-linear` | Linear issues + projects | `linear` |
| `c-jira` | Jira issues + sprints | [`jira-cli`](https://github.com/ankitpokhrel/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`.

<p align="center">
  <img src="docs/dashboard.png" alt="OpenPaw Task Dashboard" width="700">
</p>

**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

```bash
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](https://github.com/daxaur)