pawmode 1.0.0 → 1.2.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 (23) hide show
  1. package/README.md +229 -72
  2. package/dist/dashboard-server--wwlA0Pa.js +426 -0
  3. package/dist/dashboard-server-Cg_1CvKn.js +3 -0
  4. package/dist/index.js +684 -872
  5. package/dist/permissions-AJXigU7k.js +3 -0
  6. package/dist/scheduler-DAmd0GzB.js +888 -0
  7. package/dist/scheduler-DppXPNqK.js +4 -0
  8. package/dist/{skills-DwMXaN3R.js → skills-CUY0swcW.js} +1 -1
  9. package/package.json +1 -1
  10. package/skills/c-calendar/SKILL.md +12 -11
  11. package/skills/c-clipboard/SKILL.md +53 -0
  12. package/skills/c-contacts/SKILL.md +63 -0
  13. package/skills/c-core/SKILL.md +17 -1
  14. package/skills/c-memory/SKILL.md +32 -0
  15. package/skills/c-obsidian/SKILL.md +22 -3
  16. package/skills/c-schedule/SKILL.md +98 -0
  17. package/skills/c-timer/SKILL.md +59 -0
  18. package/skills/c-video-edit/SKILL.md +147 -0
  19. package/skills/c-weather/SKILL.md +61 -0
  20. package/dist/permissions-CoaVX2ZM.js +0 -3
  21. package/skills/c-social/SKILL.md +0 -57
  22. /package/dist/{permissions-BHOAvP8i.js → permissions-BlGEHCXO.js} +0 -0
  23. /package/dist/{skills-CJ_pyPlv.js → skills-CMqq9k1-.js} +0 -0
package/README.md CHANGED
@@ -1,14 +1,45 @@
1
1
  <p align="center">
2
2
  <pre align="center">
3
- ▄██▄ ▄██▄
4
- ▀██▀ ▀██▀
5
- ▄██▄ ▄██▄
6
- ▀██▀ ▀██▀
7
- ▄██████▄
8
- ▄██████████▄
9
- ██████████████
10
- ▀██████████▀
11
- ▀██████▀
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
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
12
43
  </pre>
13
44
  </p>
14
45
 
@@ -17,9 +48,10 @@
17
48
  <p align="center"><i>*wags tail furiously* — your new best friend is here.</i></p>
18
49
 
19
50
  <p align="center">
20
- <a href="https://www.npmjs.com/package/openpaw"><img src="https://img.shields.io/npm/v/openpaw?color=b4783c&label=npm&style=flat-square" alt="npm"></a>
51
+ <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>
21
52
  <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>
22
53
  <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>
54
+ <img src="https://img.shields.io/node/v/pawmode?color=8a5a2a&style=flat-square" alt="node">
23
55
  </p>
24
56
 
25
57
  ---
@@ -27,25 +59,25 @@
27
59
  ## Quick Start
28
60
 
29
61
  ```bash
30
- npx openpaw
62
+ npx pawmode
31
63
  ```
32
64
 
33
65
  Pick your skills. Choose terminal, Telegram, or both. Claude does the rest. Good boy.
34
66
 
35
67
  ```bash
36
68
  # Skip the wizard with a preset
37
- npx openpaw --preset essentials
38
- npx openpaw --preset developer --yes
69
+ npx pawmode --preset essentials
70
+ npx pawmode --preset developer --yes
39
71
  ```
40
72
 
41
73
  ---
42
74
 
43
75
  ## What is OpenPaw?
44
76
 
45
- OpenPaw turns **Claude Code** into a full personal assistant. One command, 30+ skills, and a really good boy who fetches your emails, plays your music, and controls your smart home.
77
+ OpenPaw turns **Claude Code** into a full personal assistant. One command, 39 skills, and a really good boy who fetches your emails, plays your music, and controls your smart home.
46
78
 
47
79
  ```
48
- npx openpaw
80
+ npx pawmode
49
81
  ┌───────────────────────────────────────┐
50
82
  │ How should we set things up, human? │
51
83
  │ │
@@ -55,8 +87,7 @@ npx openpaw
55
87
 
56
88
  How do you want to talk to Claude? 🐾
57
89
  > 🖥 Terminal only
58
- > 📱 Telegram
59
- > 🖥📱 Both
90
+ > 🖥📱 Terminal + Telegram
60
91
 
61
92
  ✔ Sniffed out Homebrew taps
62
93
  ✔ Taught Claude new tricks
@@ -76,7 +107,40 @@ Then just talk to Claude — from your terminal or your phone:
76
107
  > "Go to hacker news and summarize the top 5 posts"
77
108
  ```
78
109
 
79
- **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. 🐾
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
+ ---
115
+
116
+ ## What's New in v1.2.0
117
+
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
123
+
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
134
+ ```
135
+
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)
80
144
 
81
145
  ---
82
146
 
@@ -105,6 +169,31 @@ Or just send a regular message. Claude figures out which skill to use.
105
169
 
106
170
  ---
107
171
 
172
+ ## Smart Scheduling
173
+
174
+ Automate recurring tasks with built-in cost control. No runaway bills.
175
+
176
+ ```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
185
+ ```
186
+
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
+
108
197
  ## PAW MODE
109
198
 
110
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.
@@ -122,9 +211,9 @@ Get started fast with a preset, or choose `Custom` to sniff through skills one b
122
211
 
123
212
  | Preset | Skills |
124
213
  |---|---|
125
- | **Everything** | All 31 skills for your platform |
126
- | **Essentials** | Email, calendar, notes, music, browser, system, notifications |
127
- | **Productivity** | Notes, Obsidian, tasks, email, calendar, Slack, cloud files |
214
+ | **Everything** | All 39 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 |
128
217
  | **Developer** | GitHub, Linear, Jira, browser, network, AI, cron |
129
218
  | **Creative & Media** | Music, video, screen, voice, browser, research |
130
219
  | **Smart Home** | Lights, speakers, Bluetooth, system, display, notifications |
@@ -133,80 +222,86 @@ Get started fast with a preset, or choose `Custom` to sniff through skills one b
133
222
 
134
223
  ## Skills
135
224
 
136
- 31 capabilities across 8 categories. Install only what you need.
225
+ 39 capabilities across 8 categories. Install only what you need.
137
226
 
138
227
  ### Productivity
139
228
 
140
229
  | Skill | Description | Tools |
141
230
  |---|---|---|
142
- | `c-notes` | Apple Notes + Reminders | `memo` `remindctl` |
143
- | `c-obsidian` | Obsidian vault management | `obsidian-cli` |
144
- | `c-notion` | Notion pages + databases | `notion-cli` |
145
- | `c-tasks` | Todoist / Things 3 / Taskwarrior | choose during setup |
231
+ | `c-notes` | Apple Notes + Reminders | [`memo`](https://github.com/antoniorodr/memo) [`remindctl`](https://github.com/nicklama/remindctl) |
232
+ | `c-obsidian` | Obsidian vault management | [`obsidian-cli`](https://github.com/yakitrak/obsidian-cli) |
233
+ | `c-notion` | Notion pages + databases | [`notion-cli`](https://github.com/litencatt/notion-cli) |
234
+ | `c-tasks` | Todoist / Things 3 / Taskwarrior | [`todoist-cli`](https://github.com/sachaos/todoist) [`things-cli`](https://github.com/thingsapi/things-cli) [`taskwarrior`](https://github.com/GothenburgBitFactory/taskwarrior) |
146
235
 
147
236
  ### Communication
148
237
 
149
238
  | Skill | Description | Tools |
150
239
  |---|---|---|
151
- | `c-email` | Read, send, search email (Gmail or IMAP) | `gog` `himalaya` |
152
- | `c-calendar` | Events + scheduling (Google or Apple) | `gog` `icalpal` |
153
- | `c-messaging` | iMessage + WhatsApp | `imsg` `wacli` |
154
- | `c-slack` | Slack channels + DMs | `slack` |
155
- | `c-social` | Twitter/X | `bird` |
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) |
243
+ | `c-slack` | Slack channels + DMs | [`slack-cli`](https://github.com/rockymadden/slack-cli) |
156
244
  | `c-telegram` | Telegram bridge (built-in) | — |
157
245
 
158
246
  ### Media
159
247
 
160
248
  | Skill | Description | Tools |
161
249
  |---|---|---|
162
- | `c-music` | Spotify playback + search | `spogo` |
163
- | `c-video` | YouTube download + convert | `yt-dlp` `ffmpeg` |
164
- | `c-screen` | Screenshots, OCR, webcam | `peekaboo` `camsnap` |
165
- | `c-voice` | Speech-to-text + TTS | `sag` `say` |
250
+ | `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/) |
252
+ | `c-video-edit` | Programmatic video creation | [`remotion`](https://github.com/remotion-dev/remotion) [`editly`](https://github.com/mifi/editly) |
253
+ | `c-screen` | Screenshots, OCR, webcam | [`peekaboo`](https://github.com/steipete/peekaboo) [`camsnap`](https://github.com/nicklama/camsnap) |
254
+ | `c-voice` | Speech-to-text + TTS | [`sag`](https://github.com/steipete/sag) |
166
255
 
167
256
  ### Smart Home
168
257
 
169
258
  | Skill | Description | Tools |
170
259
  |---|---|---|
171
- | `c-lights` | Philips Hue control | `openhue` |
172
- | `c-speakers` | Sonos speakers | `sonos` |
173
- | `c-bluetooth` | Bluetooth devices | `blu` |
260
+ | `c-lights` | Philips Hue control | [`openhue-cli`](https://github.com/openhue/openhue-cli) |
261
+ | `c-speakers` | Sonos speakers | [`sonoscli`](https://github.com/steipete/sonoscli) |
262
+ | `c-bluetooth` | Bluetooth devices | [`blucli`](https://github.com/nicklama/blucli) |
174
263
 
175
264
  ### Browser & Automation
176
265
 
177
266
  | Skill | Description | Tools |
178
267
  |---|---|---|
179
- | `c-browser` | Headless browser — navigate, click, scrape | `agent-browser` / `playwright` |
180
- | `c-cron` | Cron jobs + launchctl services | `lunchy-go` |
268
+ | `c-schedule` | Smart scheduling with cost control | built-in |
269
+ | `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) |
181
272
 
182
273
  ### System & Files
183
274
 
184
275
  | Skill | Description | Tools |
185
276
  |---|---|---|
186
- | `c-system` | macOS Swiss Army Knife — volume, wifi, battery, dock | `m` |
187
- | `c-apps` | Mac App Store from CLI | `mas` |
188
- | `c-files` | Cloud sync — Google Drive, S3, Dropbox, 70+ providers | `rclone` |
189
- | `c-display` | Display brightness + safe trash | `brightness` `trash` |
190
- | `c-notify` | Native macOS notifications | `terminal-notifier` |
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) |
281
+ | `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) |
284
+ | `c-notify` | Native macOS notifications | [`terminal-notifier`](https://github.com/julienXX/terminal-notifier) |
191
285
 
192
286
  ### Research & Utilities
193
287
 
194
288
  | Skill | Description | Tools |
195
289
  |---|---|---|
196
- | `c-research` | Summarize URLs, PDFs, videos | `summarize` |
197
- | `c-location` | Apple Maps + nearby places | `goplaces` |
198
- | `c-tracking` | Package tracking (UPS, FedEx, etc.) | `ordercli` |
199
- | `c-secrets` | 1Password / Bitwarden | `op` `bw` |
200
- | `c-network` | DNS lookups + HTTP client | `doggo` `http` |
201
- | `c-ai` | Query LLMs — pipe text, chat, summarize | `llm` `aichat` |
290
+ | `c-weather` | Weather forecasts and conditions | built-in (curl + [wttr.in](https://wttr.in)) |
291
+ | `c-research` | Summarize URLs, PDFs, videos | [`summarize`](https://github.com/steipete/summarize) |
292
+ | `c-location` | Apple Maps + nearby places | [`goplaces`](https://github.com/steipete/goplaces) |
293
+ | `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) |
296
+ | `c-ai` | Query LLMs — pipe text, chat, summarize | [`llm`](https://github.com/simonw/llm) [`aichat`](https://github.com/sigoden/aichat) |
202
297
 
203
298
  ### Developer
204
299
 
205
300
  | Skill | Description | Tools |
206
301
  |---|---|---|
207
- | `c-github` | PRs, issues, repos, actions | `gh` `jq` |
208
- | `c-linear` | Linear issues + projects | `linear` |
209
- | `c-jira` | Jira issues + sprints | `jira` |
302
+ | `c-github` | PRs, issues, repos, actions | [`gh`](https://github.com/cli/cli) [`jq`](https://github.com/jqlang/jq) |
303
+ | `c-linear` | Linear issues + projects | [`linear-cli`](https://github.com/linear/linear-cli) |
304
+ | `c-jira` | Jira issues + sprints | [`jira-cli`](https://github.com/ankitpokhrel/jira-cli) |
210
305
 
211
306
  ---
212
307
 
@@ -218,8 +313,14 @@ Get started fast with a preset, or choose `Custom` to sniff through skills one b
218
313
  | `openpaw --preset <name>` | Quick setup with a preset |
219
314
  | `openpaw --preset <name> --yes` | Non-interactive setup |
220
315
  | `openpaw --dry-run` | Preview what would be installed |
316
+ | `openpaw dashboard` | Start the task manager dashboard |
317
+ | `openpaw dashboard --theme <name>` | Change dashboard theme (paw, midnight, neon) |
221
318
  | `openpaw telegram` | Start the Telegram bridge |
222
319
  | `openpaw telegram setup` | Configure Telegram bot |
320
+ | `openpaw schedule add` | Add a scheduled job |
321
+ | `openpaw schedule list` | List scheduled jobs |
322
+ | `openpaw schedule costs` | View cost usage and daily cap |
323
+ | `openpaw schedule set-cap <usd>` | Set daily cost cap |
223
324
  | `openpaw list` | Show all available skills |
224
325
  | `openpaw add <skills>` | Add skills — `openpaw add notes music email` |
225
326
  | `openpaw remove <skills>` | Remove skills |
@@ -240,11 +341,12 @@ OpenPaw doesn't run in the background (except the optional Telegram bridge). Her
240
341
  ```
241
342
  1. You pick a preset or choose individual skills
242
343
  2. Pick your interface: terminal, Telegram, or both
243
- 3. CLI tools are installed via brew/npm/pip
244
- 4. SKILL.md files are created in ~/.claude/skills/
245
- 5. Permissions + safety hooks are configured
246
- 6. Telegram bridge is set up (if selected)
247
- 7. Claude launches in PAW MODE — ready to fetch! 🐾
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!
248
350
  ```
249
351
 
250
352
  **Skills** are SKILL.md files that Claude auto-discovers. They teach Claude how to use each CLI tool.
@@ -257,18 +359,6 @@ OpenPaw doesn't run in the background (except the optional Telegram bridge). Her
257
359
 
258
360
  ---
259
361
 
260
- ## Why OpenPaw?
261
-
262
- - **Free forever** — uses your existing Claude subscription
263
- - **No daemon** — runs once, configures, takes a nap
264
- - **No attack surface** — no open ports, no cloud dependencies
265
- - **5-minute setup** — from zero to personal assistant
266
- - **Telegram built-in** — talk to Claude from your phone
267
- - **31 skills** — email, music, smart home, GitHub, browser, and more
268
- - **Open source** — MIT license, community-driven
269
-
270
- ---
271
-
272
362
  ## The `/c` Coordinator
273
363
 
274
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.
@@ -295,6 +385,30 @@ In "both" mode, tmux splits into two panes — Claude Code on the left, Telegram
295
385
 
296
386
  ---
297
387
 
388
+ ## Architecture
389
+
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
+ ```
409
+
410
+ ---
411
+
298
412
  ## Contributing
299
413
 
300
414
  Want to teach this pup a new trick? It's easy:
@@ -330,8 +444,51 @@ Instructions for Claude on how to use the CLI tool...
330
444
 
331
445
  ---
332
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
+ - **39 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
+ ---
489
+
333
490
  ## License
334
491
 
335
492
  MIT — do whatever you want with it. Go fetch.
336
493
 
337
- Made with care (and tail wags) by [@daxaur](https://github.com/daxaur) 🐾
494
+ Made with care (and tail wags) by [@daxaur](https://github.com/daxaur)