pawmode 1.3.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/README.md +97 -380
  2. package/dist/{dashboard-server-Pnv4DFlV.js → dashboard-server-BLUIYHCS.js} +1 -1
  3. package/dist/{dashboard-server-BAyeozOa.js → dashboard-server-BiH4JLbM.js} +220 -45
  4. package/dist/index.js +1453 -238
  5. package/package.json +1 -1
  6. package/skills/c-lockin/SKILL.md +66 -0
package/README.md CHANGED
@@ -1,51 +1,5 @@
1
- <p align="center">
2
- <pre align="center">
3
- ▃▅
4
- ▁██▁ ▄█▁
5
- ▁▁▂▆▇██▃ ▅█▆
6
- ▅▆█▇▆▄███▆▂ ▁▂▆▇██▇▅▁
7
- ▁▃█▆▁ ▄███▄▁ ▆▇▇▅▄▄███▇▃▁
8
- ▁▃█▄ ▁████▂ ▁▅█▃ ▁▃████▂
9
- ▄█▇▁ ▂████▄▁ ▁▃█▇ ▁████▅▂
10
- ▅█▆ ▂█████▁ ▄█▇▁ ▂████▃
11
- ▂▁ ▆█▆ ▂█████▁ ▄█▇ ▁▂████▂
12
- ▁▅█▂ ▆█▆▁ ▁▃▇████▆▁ ▄█▇ ▂▄█████▂
13
- ▁██▄▂ ▂██▇▆▃▄▇██████ ▄██▄▇▇▃▃▆█████▁
14
- ▂█████▇▅▂▁ ▁▄▇█████████▆▂ ▃▇████████████▁ ▁▂▁
15
- ▄█▇▃ ▁███▆▁ ▁▃▆▇▇▇▇▃▄▂ ▂▆█████████▅ ▁▇█▂
16
- ▃▆▄▁ ▅███▆▃ ▄▄▅▅▅▅▂▁ ▂▄▃▄██▂
17
- ▆█▄ ▃████▄ ▁▄▄██████▄▃▃▂ ▁▂▆▇▇▆████▇▁
18
- ▆█▄ ▂████▄ ▂▅▇▇▅▅▁▃▅█▇████▆▂ ▅▇▇▅▄▁ ▂▆████▂
19
- ▇█▄ ▅████▄ ▇█▄ ▁▃▇▆████▇▂ ▂▃█▇▃ ▁ ▃███▂
20
- ▇██▅ ▂▆████▄▁ ▆█▄▁ ▁ ▅▄▅█████▅ ▆█▆▂ ▃▆███▁
21
- ▁████████████▃ ▂▇▆▂ ▄█████▆ ▃██▂ ▂▆███▆
22
- ▃█████████▅▂ ██▂ ▄█████▆ ▅██▁ ▁████▇
23
- ▂▄▄▄▄▄▄ ▇█▃▁ ▁▅█████▅ ▃██▄▇▆▁▁▄▇████▆
24
- ▁▁▁▇█▂▁ ▁ ▄██████▆▂ ▇███████████▅▁
25
- ▁▁▄▅▆██▅▂ ▁▁ ▄███████▄ ▄▅██████▆▅▂
26
- ▄██▆▅▄▂▁ ▁ ▃▆██████▇▄▂ ▁▁▁▁▁▁▁
27
- ▂██▄▁▁ ▁▄▅██████▇▆▂▁
28
- ▃▇▇▂ ▁▁ ▁ ▃▇██████▇▃▁
29
- ▁▄█▆ ▁ ▁▆█▇█████▆▂
30
- ▄██▇ ▃▅███████▅▁
31
- ▄██▇▁ ▂▂▂▁▁▂▆▇▇▇▇▇▃▁ ▄▆▄▂▇█████▃
32
- ▃▇██▇▃ ▁▂▆▆██▆▇█████████▆▄▁▁ ▁▁▁▄▇██████▃
33
- ▄█████▆▆▇███████████████████▆▃▁ ▁▄▇███████▃
34
- ▁▅█████████████████████████████▅█████████▄▁
35
- ▁▂▆█████████████████████████████████████▂
36
- ▁▂▆▆▆▆▆▆▃▂▂▂▂▂▂▂▂▂▂▂▂▂▅▆███████████▇▆▁
37
- ▃▃▇▇▇▇▇▇▇▃▃
38
-
39
- █▀▀█░█▀▀▄░█▀▀▀░█▄ █░█▀▀▄░▄▀▀▄░█ █░
40
- █ █░█▀▀ ░█▀▀ ░█ ▀█░█▀▀ ░█▀▀█░█ █ █░
41
- ▀▀▀▀░▀ ░▀▀▀▀░▀ ▀░▀ ░▀ ▀░ ▀ ▀ ░
42
- ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
43
- </pre>
44
- </p>
45
-
46
1
  <h1 align="center">OpenPaw</h1>
47
- <p align="center"><b>Personal Assistant Wizard for Claude Code</b></p>
48
- <p align="center"><i>*wags tail furiously* — your new best friend is here.</i></p>
2
+ <p align="center"><b>Turn Claude Code into a personal assistant.</b></p>
49
3
 
50
4
  <p align="center">
51
5
  <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>
@@ -54,441 +8,204 @@
54
8
  <img src="https://img.shields.io/node/v/pawmode?color=8a5a2a&style=flat-square" alt="node">
55
9
  </p>
56
10
 
57
- ---
58
-
59
- ## Quick Start
60
-
61
- ```bash
62
- npx pawmode
63
- ```
64
-
65
- Pick your skills. Choose terminal, Telegram, or both. Claude does the rest. Good boy.
66
-
67
- ```bash
68
- # Skip the wizard with a preset
69
- npx pawmode --preset essentials
70
- npx pawmode --preset developer --yes
71
- ```
11
+ <p align="center">
12
+ <img src="docs/demo.gif" alt="OpenPaw Setup Demo" width="700">
13
+ </p>
72
14
 
73
15
  ---
74
16
 
75
17
  ## What is OpenPaw?
76
18
 
77
- OpenPaw turns **Claude Code** into a full personal assistant. One command, 38 skills, and a really good boy who fetches your emails, plays your music, and controls your smart home.
19
+ [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.
78
20
 
79
- ```
80
- npx pawmode
81
- ┌───────────────────────────────────────┐
82
- │ How should we set things up, human? │
83
- │ │
84
- │ > ⚡ Quick Setup (pick a preset) │
85
- │ 🎯 Custom (sniff through skills) │
86
- └───────────────────────────────────────┘
87
-
88
- How do you want to talk to Claude? 🐾
89
- > 🖥 Terminal only
90
- > 🖥📱 Terminal + Telegram
91
-
92
- ✔ Sniffed out Homebrew taps
93
- ✔ Taught Claude new tricks
94
- ✔ Buried treats in ~/.claude/skills/
95
- ✔ Set up the doggy door (permissions)
96
- ✔ Put up the baby gate (safety hooks)
97
- ✔ All done! *tail wag intensifies*
98
- ```
99
-
100
- Then just talk to Claude — from your terminal or your phone:
101
-
102
- ```
103
- > "What emails did I get today?"
104
- > "Play lo-fi on Spotify"
105
- > "Turn the bedroom lights to 20%"
106
- > "What's on my calendar tomorrow?"
107
- > "Go to hacker news and summarize the top 5 posts"
108
- ```
109
-
110
- **No daemon.** OpenPaw runs once, writes config, gets out of the way. No subscriptions. No extra cost. Just a wizard that sets things up and takes a nap.
111
-
112
- ![OpenPaw Setup Demo](docs/demo.gif)
113
-
114
- ---
21
+ Run one command and OpenPaw:
115
22
 
116
- ## What's New in v1.2.0
23
+ - **Installs 38 skills** across email, calendar, Spotify, smart home, Slack, GitHub, Obsidian, and more
24
+ - **Sets up the CLI tools** each skill needs (via Homebrew, npm, or pip) and walks you through auth
25
+ - **Gives Claude an identity** — a name, personality, and persistent memory across sessions
26
+ - **Configures permissions and safety hooks** so Claude can act autonomously without doing anything dangerous
27
+ - **Adds a Telegram bridge** so you can talk to Claude from your phone
28
+ - **Includes a task dashboard** — a local kanban board with drag-and-drop and 3 themes
29
+ - **Enables smart scheduling** — recurring tasks with per-run and daily cost caps so nothing runs away
117
30
 
118
- - **Task Dashboard** — local kanban board with 3 themes (Paw, Midnight, Neon), drag-and-drop, runs on `localhost:3141`
119
- - **3D ASCII Title** — extruded block-character title with depth effect
120
- - **Overwrite Protection** — existing SOUL.md and skills are preserved unless you choose to update them
121
- - **4 New Skills** — Weather, Clipboard, Contacts, Timer
122
- - **Dependency Resolution** — skills that need other skills auto-install them
31
+ After setup, you just talk to Claude:
123
32
 
124
- ---
125
-
126
- ## Task Dashboard
127
-
128
- A local kanban board for your assistant. No accounts, no cloud — just a tiny server on your machine.
129
-
130
- ```bash
131
- openpaw dashboard # Start + open browser
132
- openpaw dashboard --theme midnight # Switch theme
133
- openpaw dashboard --port 8080 # Custom port
33
+ ```
34
+ "Check my email and summarize anything urgent"
35
+ "Play lo-fi beats on Spotify"
36
+ "Turn the bedroom lights to 20%"
37
+ "What's on my calendar tomorrow?"
38
+ "Add milk to my reminders"
39
+ "Go to Hacker News and summarize the top 5 posts"
134
40
  ```
135
41
 
136
- **3 themes:**
137
- - **Paw** — warm brown tones (`#b4783c`)
138
- - **Midnight** — cool dark blue (`#6688cc`)
139
- - **Neon** — cyber green on black (`#00ff88`)
140
-
141
- Features: drag-and-drop kanban, inline editing, priority dots, persistent JSON storage. The wizard asks if you want a dashboard during setup.
142
-
143
- ![Dashboard](docs/dashboard.png)
144
-
145
- ---
42
+ Claude figures out which skill to use. No special syntax needed.
146
43
 
147
- ## Telegram Bridge
44
+ **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.
148
45
 
149
- Talk to Claude from your phone. Full bidirectional. All your skills available as bot commands.
46
+ ## Quick Start
150
47
 
151
48
  ```bash
152
- # Set up during the wizard, or separately:
153
- openpaw telegram setup
154
-
155
- # Start the bridge:
156
- openpaw telegram
49
+ npx pawmode
157
50
  ```
158
51
 
159
- **Bot commands** (auto-generated from your skills):
160
- - `/email check my inbox`
161
- - `/music play some jazz`
162
- - `/notes add grocery list`
163
- - `/model sonnet` / `/model opus` / `/model haiku` — switch models on the fly
164
- - `/skills` — see what's installed
165
- - `/stop` — cancel current operation
166
- - `/clear` — fresh start
167
-
168
- Or just send a regular message. Claude figures out which skill to use.
169
-
170
- ---
171
-
172
- ## Smart Scheduling
173
-
174
- Automate recurring tasks with built-in cost control. No runaway bills.
52
+ 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:
175
53
 
176
54
  ```bash
177
- # Morning briefing to Telegram
178
- openpaw schedule add "weekdays 8am" --run "check email and summarize" --delivery telegram
179
-
180
- # Evening project summary
181
- openpaw schedule add "daily 6pm" --run "summarize today's git commits" --delivery file
182
-
183
- # Urgent email monitor (cheap with Haiku)
184
- openpaw schedule add "every 30 minutes" --run "check for urgent emails" --model haiku --budget 0.25
55
+ npx pawmode --preset essentials # common skills, no prompts
56
+ npx pawmode --preset developer --yes # fully non-interactive
185
57
  ```
186
58
 
187
- **Cost control built in:**
188
- - Daily cap: $5/day by default (configurable)
189
- - Per-run budget: $1.00 default
190
- - Jobs auto-skip if cap would be exceeded
191
- - Track spending: `openpaw schedule costs`
192
-
193
- Jobs run via launchd (macOS) or cron (Linux) — they keep running even when your terminal is closed.
194
-
195
- ---
196
-
197
- ## PAW MODE
198
-
199
- When you launch Claude through OpenPaw, it runs in **PAW MODE** — full personal assistant mode. Claude knows your name, your preferences, what skills are installed, and greets you at session start.
200
-
201
- PAW MODE is established through:
202
- - `~/.claude/SOUL.md` — your personality config
203
- - `~/.claude/skills/c-core/SKILL.md` — the coordinator brain
204
- - `~/.claude/memory/` — persistent facts across sessions
205
-
206
- ---
207
-
208
- ## Presets
209
-
210
- Get started fast with a preset, or choose `Custom` to sniff through skills one by one.
211
-
212
- | Preset | Skills |
213
- |---|---|
214
- | **Everything** | All 38 skills for your platform |
215
- | **Essentials** | Email, calendar, notes, music, weather, clipboard, browser, system, notifications |
216
- | **Productivity** | Notes, Obsidian, tasks, email, calendar, Slack, cloud files, notifications |
217
- | **Developer** | GitHub, Linear, Jira, browser, network, cron |
218
- | **Creative & Media** | Music, video, screen, voice, browser, research |
219
- | **Smart Home** | Lights, speakers, Bluetooth, system, display, notifications |
220
-
221
59
  ---
222
60
 
223
61
  ## Skills
224
62
 
225
- 38 capabilities across 8 categories. Install only what you need.
63
+ 38 skills across 8 categories. Install only what you need.
226
64
 
227
65
  ### Productivity
228
66
 
229
- | Skill | Description | Tools |
67
+ | Skill | What it does | Tools |
230
68
  |---|---|---|
231
- | `c-notes` | Apple Notes + Reminders | [`memo`](https://github.com/antoniorodr/memo) [`remindctl`](https://github.com/nicklama/remindctl) |
69
+ | `c-notes` | Apple Notes + Reminders | [`memo`](https://github.com/antoniorodr/memo), `remindctl` |
232
70
  | `c-obsidian` | Obsidian vault management | [`obsidian-cli`](https://github.com/yakitrak/obsidian-cli) |
233
71
  | `c-notion` | Notion pages + databases | [`notion-cli`](https://github.com/litencatt/notion-cli) |
234
- | `c-tasks` | Todoist / Taskwarrior | [`todoist-cli`](https://github.com/sachaos/todoist) [`taskwarrior`](https://github.com/GothenburgBitFactory/taskwarrior) |
72
+ | `c-tasks` | Todoist / Taskwarrior | [`todoist`](https://github.com/sachaos/todoist), [`taskwarrior`](https://github.com/GothenburgBitFactory/taskwarrior) |
235
73
 
236
74
  ### Communication
237
75
 
238
- | Skill | Description | Tools |
76
+ | Skill | What it does | Tools |
239
77
  |---|---|---|
240
- | `c-email` | Read, send, search email (Gmail or IMAP) | [`gog`](https://github.com/steipete/gog) [`himalaya`](https://github.com/pimalaya/himalaya) |
241
- | `c-calendar` | Events + scheduling (Google or Apple) | [`gog`](https://github.com/steipete/gog) [`icalBuddy`](https://hasseg.org/icalBuddy/) |
242
- | `c-messaging` | iMessage + WhatsApp | [`imsg`](https://github.com/steipete/imsg) [`wacli`](https://github.com/nicklama/wacli) |
78
+ | `c-email` | Gmail or IMAP — read, send, search | `gog`, [`himalaya`](https://github.com/pimalaya/himalaya) |
79
+ | `c-calendar` | Google Calendar + Apple Calendar | `gog`, [`icalBuddy`](https://hasseg.org/icalBuddy/) |
80
+ | `c-messaging` | iMessage + WhatsApp | [`imsg`](https://github.com/steipete/imsg), `wacli` |
243
81
  | `c-slack` | Slack channels + DMs | [`slack-cli`](https://github.com/rockymadden/slack-cli) |
244
82
  | `c-telegram` | Telegram bridge (built-in) | — |
245
83
 
246
84
  ### Media
247
85
 
248
- | Skill | Description | Tools |
86
+ | Skill | What it does | Tools |
249
87
  |---|---|---|
250
88
  | `c-music` | Spotify playback + search | [`spogo`](https://github.com/steipete/spogo) |
251
- | `c-video` | YouTube download + convert | [`yt-dlp`](https://github.com/yt-dlp/yt-dlp) [`ffmpeg`](https://ffmpeg.org/) |
89
+ | `c-video` | YouTube download + convert | [`yt-dlp`](https://github.com/yt-dlp/yt-dlp), [`ffmpeg`](https://ffmpeg.org/) |
252
90
  | `c-video-edit` | Programmatic video creation | [`remotion`](https://github.com/remotion-dev/remotion) |
253
- | `c-screen` | Screenshots, OCR, webcam | [`peekaboo`](https://github.com/steipete/peekaboo) [`camsnap`](https://github.com/nicklama/camsnap) |
91
+ | `c-screen` | Screenshots, OCR, webcam | [`peekaboo`](https://github.com/steipete/peekaboo), `camsnap` |
254
92
  | `c-voice` | Speech-to-text + TTS | [`sag`](https://github.com/steipete/sag) |
255
93
 
256
94
  ### Smart Home
257
95
 
258
- | Skill | Description | Tools |
96
+ | Skill | What it does | Tools |
259
97
  |---|---|---|
260
98
  | `c-lights` | Philips Hue control | [`openhue-cli`](https://github.com/openhue/openhue-cli) |
261
99
  | `c-speakers` | Sonos speakers | [`sonoscli`](https://github.com/steipete/sonoscli) |
262
- | `c-bluetooth` | Bluetooth devices | [`blucli`](https://github.com/nicklama/blucli) |
100
+ | `c-bluetooth` | Bluetooth devices | `blueutil` |
263
101
 
264
102
  ### Browser & Automation
265
103
 
266
- | Skill | Description | Tools |
104
+ | Skill | What it does | Tools |
267
105
  |---|---|---|
268
- | `c-schedule` | Smart scheduling with cost control | built-in |
106
+ | `c-browser` | Headless browser — navigate, click, scrape | `playwright` |
107
+ | `c-cron` | Cron jobs + launchctl services | `lunchy` |
108
+ | `c-schedule` | Recurring tasks with cost control | built-in |
269
109
  | `c-briefing` | Daily morning briefing | depends on email + calendar |
270
- | `c-browser` | Headless browser — navigate, click, scrape | [`agent-browser`](https://github.com/nicklama/agent-browser) [`playwright`](https://github.com/nicklama/playwright-cli) |
271
- | `c-cron` | Cron jobs + launchctl services | [`lunchy-go`](https://github.com/nicklama/lunchy-go) |
272
110
 
273
111
  ### System & Files
274
112
 
275
- | Skill | Description | Tools |
113
+ | Skill | What it does | Tools |
276
114
  |---|---|---|
277
- | `c-clipboard` | Copy, paste, transform clipboard content | built-in |
278
- | `c-contacts` | Search macOS Contacts / Address Book | built-in |
279
- | `c-timer` | Countdown timers, alarms, pomodoro | [`terminal-notifier`](https://github.com/julienXX/terminal-notifier) |
280
- | `c-system` | macOS Swiss Army Knife — volume, wifi, battery, dock | [`m-cli`](https://github.com/rgcr/m-cli) |
115
+ | `c-system` | Volume, wifi, battery, dock | [`m-cli`](https://github.com/rgcr/m-cli) |
281
116
  | `c-apps` | Mac App Store from CLI | [`mas`](https://github.com/mas-cli/mas) |
282
- | `c-files` | Cloud sync — Google Drive, S3, Dropbox, 70+ providers | [`rclone`](https://github.com/rclone/rclone) |
283
- | `c-display` | Display brightness + safe trash | [`brightness`](https://github.com/nriley/brightness) [`macos-trash`](https://github.com/sindresorhus/macos-trash) |
117
+ | `c-files` | Cloud sync (Drive, S3, Dropbox, 70+) | [`rclone`](https://github.com/rclone/rclone) |
118
+ | `c-display` | Brightness + safe trash | [`brightness`](https://github.com/nriley/brightness), [`macos-trash`](https://github.com/sindresorhus/macos-trash) |
284
119
  | `c-notify` | Native macOS notifications | [`terminal-notifier`](https://github.com/julienXX/terminal-notifier) |
120
+ | `c-clipboard` | Copy, paste, transform clipboard | built-in |
121
+ | `c-contacts` | Search macOS Contacts | built-in |
122
+ | `c-timer` | Countdown, alarms, pomodoro | [`terminal-notifier`](https://github.com/julienXX/terminal-notifier) |
285
123
 
286
124
  ### Research & Utilities
287
125
 
288
- | Skill | Description | Tools |
126
+ | Skill | What it does | Tools |
289
127
  |---|---|---|
290
- | `c-weather` | Weather forecasts and conditions | built-in (curl + [wttr.in](https://wttr.in)) |
128
+ | `c-weather` | Weather forecasts | built-in (curl + [wttr.in](https://wttr.in)) |
291
129
  | `c-research` | Summarize URLs, PDFs, videos | [`summarize`](https://github.com/steipete/summarize) |
292
130
  | `c-location` | Apple Maps + nearby places | [`goplaces`](https://github.com/steipete/goplaces) |
293
131
  | `c-tracking` | Package tracking (UPS, FedEx, etc.) | [`ordercli`](https://github.com/steipete/ordercli) |
294
- | `c-secrets` | 1Password / Bitwarden | [`op`](https://developer.1password.com/docs/cli/) [`bw`](https://github.com/bitwarden/clients) |
295
- | `c-network` | DNS lookups + HTTP client | [`doggo`](https://github.com/mr-karan/doggo) [`httpie`](https://github.com/httpie/cli) |
132
+ | `c-secrets` | 1Password / Bitwarden | [`op`](https://developer.1password.com/docs/cli/), [`bw`](https://github.com/bitwarden/clients) |
133
+ | `c-network` | DNS + HTTP client | [`doggo`](https://github.com/mr-karan/doggo), [`httpie`](https://github.com/httpie/cli) |
296
134
 
297
135
  ### Developer
298
136
 
299
- | Skill | Description | Tools |
137
+ | Skill | What it does | Tools |
300
138
  |---|---|---|
301
- | `c-github` | PRs, issues, repos, actions | [`gh`](https://github.com/cli/cli) [`jq`](https://github.com/jqlang/jq) |
302
- | `c-linear` | Linear issues + projects | [`linear-cli`](https://github.com/linear/linear-cli) |
139
+ | `c-github` | PRs, issues, repos, actions | [`gh`](https://github.com/cli/cli), [`jq`](https://github.com/jqlang/jq) |
140
+ | `c-linear` | Linear issues + projects | `linear` |
303
141
  | `c-jira` | Jira issues + sprints | [`jira-cli`](https://github.com/ankitpokhrel/jira-cli) |
304
142
 
305
143
  ---
306
144
 
307
- ## Commands
145
+ ## Presets
308
146
 
309
- | Command | Description |
147
+ | Preset | Skills |
310
148
  |---|---|
311
- | `openpaw` | Interactive setup wizard |
312
- | `openpaw --preset <name>` | Quick setup with a preset |
313
- | `openpaw --preset <name> --yes` | Non-interactive setup |
314
- | `openpaw --dry-run` | Preview what would be installed |
315
- | `openpaw dashboard` | Start the task manager dashboard |
316
- | `openpaw dashboard --theme <name>` | Change dashboard theme (paw, midnight, neon) |
317
- | `openpaw telegram` | Start the Telegram bridge |
318
- | `openpaw telegram setup` | Configure Telegram bot |
319
- | `openpaw schedule add` | Add a scheduled job |
320
- | `openpaw schedule list` | List scheduled jobs |
321
- | `openpaw schedule costs` | View cost usage and daily cap |
322
- | `openpaw schedule set-cap <usd>` | Set daily cost cap |
323
- | `openpaw configure` | Configure your setup — add skills, personality, dashboard |
324
- | `openpaw list` | Show all available skills |
325
- | `openpaw add <skills>` | Add skills — `openpaw add notes music email` |
326
- | `openpaw remove <skills>` | Remove skills |
327
- | `openpaw status` | Show installed skills + tool versions |
328
- | `openpaw doctor` | Diagnose issues |
329
- | `openpaw update` | Upgrade CLI tools |
330
- | `openpaw soul` | Edit personality (SOUL.md) |
331
- | `openpaw export` | Export config + memory |
332
- | `openpaw import <file>` | Import config from file |
333
- | `openpaw reset` | Remove everything OpenPaw installed |
334
-
335
- ---
336
-
337
- ## How It Works
338
-
339
- OpenPaw doesn't run in the background (except the optional Telegram bridge). Here's what happens:
340
-
341
- ```
342
- 1. You pick a preset or choose individual skills
343
- 2. Pick your interface: terminal, Telegram, or both
344
- 3. Optionally set up a task dashboard with your preferred theme
345
- 4. CLI tools are installed via brew/npm/pip
346
- 5. SKILL.md files are created in ~/.claude/skills/
347
- 6. Permissions + safety hooks are configured
348
- 7. Telegram bridge is set up (if selected)
349
- 8. Claude launches in PAW MODE — ready to fetch!
350
- ```
351
-
352
- **Skills** are SKILL.md files that Claude auto-discovers. They teach Claude how to use each CLI tool.
353
-
354
- **Permissions** let Claude run tools without prompting you every time. Only the minimum needed.
355
-
356
- **Safety hooks** block dangerous patterns like mass-delete, mass-email, and credential exposure. Baby gate = installed.
357
-
358
- **`--dangerously-skip-permissions`** lets Claude actually be your assistant. The wizard explains this and asks before enabling. Safety hooks still protect you.
149
+ | **Everything** | All 38 skills |
150
+ | **Essentials** | Email, calendar, notes, music, weather, clipboard, browser, system, notifications |
151
+ | **Productivity** | Notes, Obsidian, tasks, email, calendar, Slack, cloud files, notifications |
152
+ | **Developer** | GitHub, Linear, Jira, browser, network, cron |
153
+ | **Creative** | Music, video, screen, voice, browser, research |
154
+ | **Smart Home** | Lights, speakers, Bluetooth, system, display, notifications |
359
155
 
360
156
  ---
361
157
 
362
- ## The `/c` Coordinator
158
+ ## Features
363
159
 
364
- Every OpenPaw install includes `c-core` — a coordinator skill that acts as the brain. It knows what's installed and routes your requests to the right tool.
160
+ **Telegram Bridge** — Talk to Claude from your phone. Set up with `openpaw telegram setup`, start with `openpaw telegram`.
365
161
 
366
- ```
367
- /c what emails came in today?
368
- /c play something chill on spotify
369
- /c add "buy groceries" to my reminders
370
- /c search my obsidian vault for project ideas
371
- ```
372
-
373
- ---
374
-
375
- ## tmux Support
162
+ **Task Dashboard** — Local kanban board with 3 themes (Paw, Midnight, Neon). Run `openpaw dashboard`.
376
163
 
377
- For the Telegram bridge (or running "both" mode), OpenPaw can set up a tmux session:
164
+ <p align="center">
165
+ <img src="docs/dashboard.png" alt="OpenPaw Task Dashboard" width="700">
166
+ </p>
378
167
 
379
- ```bash
380
- # The wizard offers this automatically, or:
381
- tmux new-session -s openpaw 'openpaw telegram'
382
- ```
168
+ **Scheduling** — Recurring tasks with per-run and daily cost caps. `openpaw schedule add "weekdays 8am" --run "check email"`.
383
169
 
384
- In "both" mode, tmux splits into two panes — Claude Code on the left, Telegram bridge on the right.
170
+ **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.
385
171
 
386
172
  ---
387
173
 
388
- ## Architecture
174
+ ## Commands
389
175
 
390
- ```
391
- ~/.claude/
392
- ├── SOUL.md # Personality (name, tone, proactivity)
393
- ├── skills/
394
- │ ├── c-core/SKILL.md # Coordinator brain
395
- │ ├── c-memory/SKILL.md # Memory management
396
- │ ├── c-email/SKILL.md # Email skill
397
- │ ├── c-music/SKILL.md # Spotify skill
398
- │ └── ... # More skills
399
- ├── memory/
400
- │ ├── MEMORY.md # Persistent facts
401
- │ ├── journal.md # Session logs
402
- │ ├── people.md # Contact notes
403
- │ └── preferences.md # User preferences
404
- └── settings.json # Permissions + hooks
405
-
406
- ~/.config/openpaw/
407
- └── dashboard.json # Dashboard tasks + theme
408
- ```
176
+ | Command | Description |
177
+ |---|---|
178
+ | `openpaw` | Interactive setup wizard |
179
+ | `openpaw configure` | Menu to add skills, edit personality, manage dashboard |
180
+ | `openpaw add <skills>` | Add skills — `openpaw add notes music email` |
181
+ | `openpaw remove <skills>` | Remove skills |
182
+ | `openpaw list` | Show all available skills |
183
+ | `openpaw status` | Show installed skills + tool versions |
184
+ | `openpaw doctor` | Diagnose issues |
185
+ | `openpaw update` | Upgrade CLI tools |
186
+ | `openpaw dashboard` | Task dashboard (`--theme midnight`, `--port 8080`) |
187
+ | `openpaw telegram` | Start Telegram bridge |
188
+ | `openpaw schedule add` | Add a scheduled job |
189
+ | `openpaw schedule list` | List scheduled jobs |
190
+ | `openpaw schedule costs` | View cost usage |
191
+ | `openpaw soul` | Edit personality |
192
+ | `openpaw export` / `import` | Backup and restore config |
193
+ | `openpaw reset` | Remove everything OpenPaw installed |
409
194
 
410
195
  ---
411
196
 
412
197
  ## Contributing
413
198
 
414
- Want to teach this pup a new trick? It's easy:
415
-
416
199
  ```bash
417
- # 1. Fork the repo
418
200
  gh repo fork daxaur/openpaw
419
-
420
- # 2. Create your skill template
421
201
  mkdir skills/c-yourskill
422
- # Write a SKILL.md with YAML frontmatter + usage instructions
423
-
424
- # 3. Add tool definitions to the catalog
425
- # Edit src/catalog/index.ts
426
-
427
- # 4. Submit a PR
202
+ # Write a SKILL.md with YAML frontmatter (name, description, tags)
203
+ # Add tool definitions to src/catalog/index.ts
428
204
  gh pr create
429
205
  ```
430
206
 
431
- ### Skill template format
432
-
433
- ```markdown
434
- ---
435
- name: c-yourskill
436
- description: Short description (under 400 chars)
437
- tags: [tag1, tag2]
438
- ---
439
-
440
- # Your Skill Name
441
-
442
- Instructions for Claude on how to use the CLI tool...
443
- ```
444
-
445
- ---
446
-
447
- ## Why OpenPaw?
448
-
449
- - **Free forever** — uses your existing Claude subscription
450
- - **No daemon** — runs once, configures, takes a nap
451
- - **No attack surface** — no open ports, no cloud dependencies
452
- - **5-minute setup** — from zero to personal assistant
453
- - **Telegram built-in** — talk to Claude from your phone
454
- - **Task dashboard** — local kanban board with 3 themes
455
- - **38 skills** — email, music, smart home, GitHub, scheduling, video editing, and more
456
- - **Cost-controlled scheduling** — automate tasks without runaway bills
457
- - **Open source** — MIT license, community-driven
458
-
459
- ---
460
-
461
- ## Changelog
462
-
463
- ### v1.2.0
464
- - Task manager dashboard with 3 themes (Paw, Midnight, Neon)
465
- - 3D ASCII title with extruded depth effect
466
- - Overwrite protection for existing SOUL.md and skills
467
- - 4 new skills: Weather, Clipboard, Contacts, Timer
468
- - Dependency resolution for skill prerequisites
469
- - Dashboard integrated into setup wizard
470
-
471
- ### v1.1.0
472
- - Smart scheduling with cost control
473
- - Video editing skill (Remotion + Editly)
474
- - Obsidian memory integration
475
- - Daily briefing skill
476
- - Telegram + Discord curl-based bridge
477
- - MCP server setup
478
- - Soul export/import
479
-
480
- ### v1.0.0
481
- - Initial release
482
- - 32 skills across 8 categories
483
- - Interactive setup wizard with presets
484
- - Telegram bridge
485
- - PAW MODE with SOUL.md personality
486
- - Safety hooks and permission management
487
-
488
207
  ---
489
208
 
490
209
  ## License
491
210
 
492
- MIT — do whatever you want with it. Go fetch.
493
-
494
- Made with care (and tail wags) by [@daxaur](https://github.com/daxaur)
211
+ MIT — [@daxaur](https://github.com/daxaur)
package/dist/{dashboard-server-Pnv4DFlV.js → dashboard-server-BLUIYHCS.js} RENAMED
@@ -1,3 +1,3 @@
1
- import { CONFIG_FILE, readConfig, startDashboard, writeConfig } from "./dashboard-server-BAyeozOa.js";
1
+ import { CONFIG_FILE, readConfig, startDashboard, writeConfig } from "./dashboard-server-BiH4JLbM.js";
2
2
 
3
3
  export { startDashboard };