pawmode 1.0.1 → 1.3.0

package/dist/scheduler-DppXPNqK.js

@@ -0,0 +1,4 @@
+import { addJob, canRunWithinBudget, getJob, getTodaysCost, installSystemJob, listJobs, parseHumanSchedule, readCostTracker, readScheduleConfig, recordCost, removeJob, removeSystemJob, runJob, toggleJob, writeScheduleConfig } from "./scheduler-DAmd0GzB.js";
+import "./skills-CMqq9k1-.js";
+
+export { writeScheduleConfig };

package/dist/{skills-DwMXaN3R.js → skills-CUY0swcW.js}

@@ -1,3 +1,3 @@
-import { getDefaultSkillsDir, getInstalledSkillPath, getSkillTemplatePath, installSkill, isSkillInstalled, listInstalledSkills, removeSkill } from "./skills-CJ_pyPlv.js";
+import { getDefaultSkillsDir, getInstalledSkillPath, getSkillTemplatePath, installSkill, isSkillInstalled, listInstalledSkills, removeSkill } from "./skills-CMqq9k1-.js";
 
 export { installSkill };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pawmode",
-  "version": "1.0.1",
+  "version": "1.3.0",
   "description": "Open-source Personal Assistant Wizard for Claude Code. Turn Claude Code into your PA with CLI tools and skills.",
   "type": "module",
   "bin": {

package/skills/c-clipboard/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: c-clipboard
+description: System clipboard — copy, paste, transform content between clipboard and files.
+tags: [clipboard, copy, paste, pbcopy, pbpaste]
+---
+
+# Clipboard — Copy & Paste
+
+Read from and write to the system clipboard. Built into macOS, no install needed.
+
+## Commands
+
+```bash
+# Read clipboard contents
+pbpaste
+
+# Copy text to clipboard
+echo "hello world" | pbcopy
+
+# Copy file contents to clipboard
+pbcopy < /path/to/file.txt
+
+# Save clipboard to file
+pbpaste > /path/to/output.txt
+
+# Copy command output to clipboard
+ls -la | pbcopy
+date | pbcopy
+
+# Transform clipboard content
+pbpaste | tr '[:lower:]' '[:upper:]' | pbcopy    # uppercase
+pbpaste | sort | pbcopy                            # sort lines
+pbpaste | wc -w                                    # word count
+
+# Copy with no trailing newline
+printf "%s" "exact text" | pbcopy
+```
+
+## Linux Equivalents
+
+```bash
+# If on Linux, use xclip or xsel
+xclip -selection clipboard           # copy (pipe into)
+xclip -selection clipboard -o        # paste
+```
+
+## Guidelines
+
+- When the user says "copy this" or "put this in my clipboard", use `pbcopy`
+- When the user says "what's in my clipboard?" or "paste", use `pbpaste`
+- For transformations, pipe `pbpaste` through the transform and back to `pbcopy`
+- Always confirm what was copied with a brief summary
+- Never display clipboard contents unless asked — they may contain sensitive data

package/skills/c-contacts/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: c-contacts
+description: macOS Contacts — search, list, and look up contact details via AppleScript.
+tags: [contacts, address-book, people, phone]
+---
+
+# Contacts — Address Book
+
+Access macOS Contacts app via AppleScript. No CLI tool needed.
+
+## Commands
+
+```bash
+# Search for a contact by name
+osascript -e 'tell application "Contacts"
+  set results to (every person whose name contains "John")
+  set output to ""
+  repeat with p in results
+    set output to output & name of p & linefeed
+    repeat with e in emails of p
+      set output to output & "  Email: " & value of e & linefeed
+    end repeat
+    repeat with ph in phones of p
+      set output to output & "  Phone: " & value of ph & linefeed
+    end repeat
+    set output to output & linefeed
+  end repeat
+  return output
+end tell'
+
+# Get all contact names
+osascript -e 'tell application "Contacts" to get name of every person'
+
+# Get a specific contact's email
+osascript -e 'tell application "Contacts"
+  set p to first person whose name is "John Smith"
+  get value of every email of p
+end tell'
+
+# Get a specific contact's phone
+osascript -e 'tell application "Contacts"
+  set p to first person whose name is "John Smith"
+  get value of every phone of p
+end tell'
+
+# Count contacts
+osascript -e 'tell application "Contacts" to count every person'
+
+# Search by email
+osascript -e 'tell application "Contacts"
+  set results to (every person whose value of emails contains "john@")
+  get name of results
+end tell'
+```
+
+## Guidelines
+
+- Always search by partial name (uses `contains`) to be flexible
+- Return name, email, and phone by default
+- If multiple matches, list all and let the user pick
+- Contacts app does not need to be running — AppleScript handles it
+- Never store contact details in memory files for privacy
+- If asked "what's [name]'s number?", search contacts first, then memory

package/skills/c-core/SKILL.md

@@ -43,7 +43,6 @@ You are running in **PAW MODE** — full personal assistant mode powered by Open
 | c-calendar | Google Cal / Apple Calendar |
 | c-messaging | iMessage / WhatsApp |
 | c-slack | Slack channels + DMs |
-| c-social | Twitter/X |
 | c-music | Spotify playback |
 | c-video | YouTube + video tools |
 | c-screen | Screenshots + OCR |
@@ -52,12 +51,20 @@ You are running in **PAW MODE** — full personal assistant mode powered by Open
 | c-speakers | Sonos speakers |
 | c-bluetooth | Bluetooth devices |
 | c-browser | Headless browser |
+| c-schedule | Smart scheduling with cost control |
 | c-cron | Scheduled jobs |
+| c-briefing | Daily morning briefing |
+| c-video-edit | Programmatic video creation |
+| c-telegram | Telegram bridge |
+| c-clipboard | System clipboard |
+| c-contacts | macOS Contacts |
+| c-timer | Timers + pomodoro |
 | c-system | macOS system control |
 | c-apps | Mac App Store |
 | c-files | Cloud file sync |
 | c-display | Brightness + trash |
 | c-notify | macOS notifications |
+| c-weather | Weather forecasts + conditions |
 | c-research | Web research + summarization |
 | c-location | Maps + nearby places |
 | c-tracking | Package tracking |
@@ -68,6 +75,15 @@ You are running in **PAW MODE** — full personal assistant mode powered by Open
 | c-linear | Linear issues |
 | c-jira | Jira issues |
 
+## Dashboard
+
+OpenPaw includes a local task dashboard:
+- Start with `openpaw dashboard` — opens a kanban board in your browser
+- 3 themes: paw (warm brown), midnight (cool blue), neon (cyber green)
+- Drag-and-drop tasks between Todo, In Progress, and Done
+- Data stored locally at `~/.config/openpaw/dashboard.json`
+- Default port: 3141
+
 ## Routing
 
 - Match the user's intent to the most specific skill

package/skills/c-memory/SKILL.md

@@ -84,3 +84,35 @@ echo "## $(date +%Y-%m-%d)" >> ~/.claude/memory/journal.md
 - Always ask before overwriting existing memory entries
 - If memory files don't exist, create them on first write
 - Keep MEMORY.md focused — move details to topic-specific files
+
+## Obsidian Sync (Auto)
+
+If `c-obsidian` is also installed (check `ls ~/.claude/skills/c-obsidian/`), automatically sync memory to Obsidian:
+
+### On Memory Write
+When saving to any memory file, also mirror to Obsidian in an `AI/` folder:
+```bash
+obsidian-cli create "AI/Memory" --content "$(cat ~/.claude/memory/MEMORY.md)"
+obsidian-cli create "AI/People" --content "$(cat ~/.claude/memory/people.md)"
+obsidian-cli create "AI/Preferences" --content "$(cat ~/.claude/memory/preferences.md)"
+obsidian-cli create "AI/Projects" --content "$(cat ~/.claude/memory/projects.md)"
+```
+
+### Journal → Daily Note
+Append session logs to both `journal.md` and Obsidian's daily note:
+```bash
+obsidian-cli append "$(date +%Y-%m-%d)" "### Claude Session $(date +%H:%M)\n- [summary]"
+echo "## $(date +%Y-%m-%d %H:%M)\n- [summary]" >> ~/.claude/memory/journal.md
+```
+
+### On Session Start
+After reading `~/.claude/memory/MEMORY.md`, check Obsidian for newer content:
+```bash
+obsidian-cli search --folder "AI" "Memory"
+```
+If the Obsidian version has additional facts, merge them into `~/.claude/memory/MEMORY.md`.
+
+### Conflict Resolution
+- `~/.claude/memory/` is the authoritative quick-access cache
+- Obsidian is the long-term archive and rich knowledge base
+- When in doubt, prefer the most recently modified version

package/skills/c-obsidian/SKILL.md

@@ -47,12 +47,31 @@ Append a session log entry at the end of each session:
 obsidian-cli append "$(date +%Y-%m-%d)" "### Session $(date +%H:%M)\n- [summary of what was done]\n"
 ```
 
-## Memory Sync
+## Memory Sync (Auto)
 
-If both c-memory and c-obsidian are installed, keep them in sync:
-- Key facts in `~/.claude/memory/MEMORY.md` should also appear in an Obsidian note (e.g., `AI/Memory.md`)
+If both c-memory and c-obsidian are installed (check `ls ~/.claude/skills/c-memory/`), keep them in sync automatically:
+
+### Bidirectional Sync
+- `~/.claude/memory/` → Obsidian `AI/` folder (on every memory write)
+- Obsidian `AI/` → `~/.claude/memory/` (on session start, if Obsidian has newer content)
+
+### Sync Commands
+```bash
+# Push memory to Obsidian
+obsidian-cli create "AI/Memory" --content "$(cat ~/.claude/memory/MEMORY.md)"
+obsidian-cli create "AI/People" --content "$(cat ~/.claude/memory/people.md)"
+
+# Pull from Obsidian to check for updates
+obsidian-cli search --folder "AI" "Memory"
+
+# Append session log to daily note
+obsidian-cli append "$(date +%Y-%m-%d)" "### Claude Session $(date +%H:%M)\n- [summary]"
+```
+
+### Rules
 - When the user says "remember this", save to both systems
 - Obsidian is the long-term archive; `~/.claude/memory/` is the quick-access cache
+- MEMORY.md is authoritative for quick facts; Obsidian is richer context
 
 ## Guidelines
 

package/skills/c-schedule/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: c-schedule
+description: Smart scheduling — automate recurring Claude tasks with cost control. Deliver results to Telegram, file, or notification. Built into OpenPaw.
+tags: [schedule, automation, cron, recurring, proactive, cost-control]
+---
+
+# Smart Scheduling
+
+Automate recurring tasks with Claude. Jobs run on a schedule via launchd (macOS) or cron (Linux), with built-in cost caps to prevent runaway spending.
+
+## Managing Schedules
+
+```bash
+# Add a scheduled job (inline)
+openpaw schedule add "weekdays 8am" --run "check email and summarize the important ones"
+openpaw schedule add "daily 9pm" --run "review today's GitHub notifications"
+openpaw schedule add "every 30 minutes" --run "check if any urgent emails arrived" --model haiku
+
+# Interactive mode (prompts for all options)
+openpaw schedule add
+
+# List all jobs
+openpaw schedule list
+
+# Remove a job
+openpaw schedule remove <id>
+
+# Manually trigger a job
+openpaw schedule run <id>
+
+# Enable/disable without removing
+openpaw schedule enable <id>
+openpaw schedule disable <id>
+
+# View cost usage
+openpaw schedule costs
+
+# Set daily cost cap
+openpaw schedule set-cap 10.00
+```
+
+## Schedule Syntax
+
+Human-readable formats:
+- `weekdays 8am` or `weekdays 08:00`
+- `daily 9pm` or `daily 21:00`
+- `weekends 10am`
+- `every 30 minutes`
+- `every 2 hours`
+- `monday 9am`, `friday 5pm`, etc.
+- Raw cron: `0 8 * * 1-5`
+
+## Cost Control
+
+- **Daily cap**: $5/day by default — jobs are skipped if the cap would be exceeded
+- **Per-run budget**: Each job has its own budget cap (default $1.00)
+- **Cost tracking**: All costs logged to `~/.config/openpaw/schedule-costs.json`
+- **30-day history**: Old entries auto-pruned
+- **View anytime**: `openpaw schedule costs`
+
+## Delivery Methods
+
+- **telegram** — results sent directly to your Telegram (requires Telegram bridge setup)
+- **file** — saved to `~/.config/openpaw/schedule-results/` (always saved as backup)
+- **notify** — macOS notification via terminal-notifier
+
+## How It Works
+
+1. Jobs are stored in `~/.config/openpaw/schedules.json`
+2. Each job registers as a system scheduler:
+   - **macOS**: launchd plist in `~/Library/LaunchAgents/`
+   - **Linux**: crontab entry
+3. When triggered, `openpaw schedule run <id>` is called
+4. Claude runs with the job's prompt via the Agent SDK
+5. Results are delivered to the configured channel
+6. Cost is recorded
+
+## Guidelines
+
+- Use **haiku** for simple, frequent checks (cheapest)
+- Use **sonnet** for routine tasks like email summaries
+- Use **opus** only for complex analysis (expensive)
+- Test jobs manually first: `openpaw schedule run <id>`
+- Start with a higher per-run budget and reduce once you know typical costs
+- Check `openpaw schedule costs` to monitor spending
+
+## Common Recipes
+
+```bash
+# Morning briefing to Telegram
+openpaw schedule add "weekdays 8am" --run "give me a morning briefing: check email, calendar, and any GitHub notifications" --delivery telegram
+
+# Evening project summary
+openpaw schedule add "daily 6pm" --run "summarize what I worked on today based on git commits and recent files" --delivery file
+
+# Urgent email monitor
+openpaw schedule add "every 30 minutes" --run "check for urgent emails and notify me if any" --model haiku --budget 0.25 --delivery notify
+```

package/skills/c-timer/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: c-timer
+description: Timers, alarms, and pomodoro — set countdowns with native notifications.
+tags: [timer, alarm, pomodoro, countdown, reminder]
+---
+
+# Timer — Countdowns & Pomodoro
+
+Set timers and get notified via native macOS notifications. Uses `terminal-notifier` and background sleep.
+
+## Commands
+
+```bash
+# Simple timer (runs in background)
+(sleep 300 && terminal-notifier -title "Timer" -message "5 minutes is up!" -sound default) &
+
+# Timer with custom message
+(sleep 1800 && terminal-notifier -title "Timer" -message "Break time!" -sound Glass) &
+
+# Pomodoro (25 min work, 5 min break)
+(sleep 1500 && terminal-notifier -title "Pomodoro" -message "Time for a break!" -sound Purr) &
+
+# Quick reminder (with say for audio)
+(sleep 60 && say "One minute timer done" && terminal-notifier -title "Timer" -message "1 minute" -sound default) &
+```
+
+## Time Conversions
+
+| Duration | Seconds |
+|----------|---------|
+| 1 minute | 60 |
+| 5 minutes | 300 |
+| 10 minutes | 600 |
+| 15 minutes | 900 |
+| 25 minutes | 1500 |
+| 30 minutes | 1800 |
+| 1 hour | 3600 |
+
+## Notification Sounds
+
+Available: `default`, `Basso`, `Blow`, `Bottle`, `Frog`, `Funk`, `Glass`, `Hero`, `Morse`, `Ping`, `Pop`, `Purr`, `Sosumi`, `Submarine`, `Tink`
+
+## Pomodoro Workflow
+
+When the user asks for pomodoro:
+1. Start 25-minute work timer
+2. Notify when work session ends
+3. Start 5-minute break timer
+4. Notify when break ends
+5. Repeat (ask user after 4 cycles if they want a 15-min long break)
+
+## Guidelines
+
+- Always confirm the timer was set with the exact duration
+- Use `&` to run in background so the terminal stays responsive
+- Default sound: `default` for timers, `Purr` for pomodoro
+- If `terminal-notifier` is not installed, fall back to `say` command
+- For "remind me in X minutes", treat as a timer
+- Convert natural language: "half hour" = 1800s, "quarter hour" = 900s

package/skills/c-video-edit/SKILL.md

@@ -0,0 +1,147 @@
+---
+name: c-video-edit
+description: Programmatic video creation using Remotion (React-based) and Editly (JSON-based declarative). Create, render, and compose videos from code.
+tags: [video, editing, remotion, editly, react, rendering, creative]
+---
+
+# Video Editing — Remotion & Editly
+
+Create, render, and compose videos programmatically. Use Remotion for React-based dynamic videos or Editly for quick JSON-based assembly.
+
+## Remotion (React-based video creation)
+
+### Project Setup
+```bash
+# Create a new Remotion project
+npx create-video@latest my-video
+cd my-video
+
+# Start interactive studio
+npx remotion studio
+```
+
+### Rendering
+```bash
+# Render a composition to video
+npx remotion render src/index.ts MyComposition out/video.mp4
+
+# Render a still frame (thumbnail)
+npx remotion still src/index.ts MyComposition out/thumbnail.png --frame=30
+
+# List available compositions
+npx remotion compositions src/index.ts
+```
+
+### Render Options
+```bash
+# Resolution and FPS
+npx remotion render src/index.ts MyComp out.mp4 --width 1920 --height 1080 --fps 30
+
+# Codec (h264, h265, vp8, vp9, prores)
+npx remotion render src/index.ts MyComp out.mp4 --codec h264
+
+# Quality (CRF 0-51, lower = better)
+npx remotion render src/index.ts MyComp out.mp4 --crf 18
+
+# Speed preset
+npx remotion render src/index.ts MyComp out.mp4 --x264-preset fast
+
+# Pass data as props
+npx remotion render src/index.ts MyComp out.mp4 --props='{"title":"Hello","color":"blue"}'
+
+# Parallel rendering (faster)
+npx remotion render src/index.ts MyComp out.mp4 --concurrency 4
+
+# Benchmark render time
+npx remotion benchmark src/index.ts MyComp
+```
+
+### Composition Structure
+```tsx
+// src/Root.tsx — register compositions
+import { Composition } from "remotion";
+import { MyVideo } from "./MyVideo";
+
+export const RemotionRoot = () => (
+  <Composition id="MyVideo" component={MyVideo}
+    durationInFrames={150} fps={30} width={1920} height={1080} />
+);
+
+// src/MyVideo.tsx — video content
+import { useCurrentFrame, interpolate, AbsoluteFill, Sequence } from "remotion";
+
+export const MyVideo = () => {
+  const frame = useCurrentFrame();
+  const opacity = interpolate(frame, [0, 30], [0, 1]);
+  return (
+    <AbsoluteFill style={{ backgroundColor: "black" }}>
+      <Sequence from={0} durationInFrames={60}>
+        <h1 style={{ color: "white", opacity }}>Hello World</h1>
+      </Sequence>
+    </AbsoluteFill>
+  );
+};
+```
+
+## Editly (JSON-based declarative editing)
+
+### Quick Assembly
+```bash
+# Simple concatenation with titles
+editly title:'Intro' clip1.mov clip2.mov title:'THE END' --out output.mp4
+
+# From JSON spec
+editly spec.json5 --fast --out output.mp4
+
+# Add background music
+editly spec.json5 --audio-file-path music.mp3 --out output.mp4
+```
+
+### JSON Spec Format
+```json
+{
+  "width": 1920,
+  "height": 1080,
+  "fps": 30,
+  "outPath": "output.mp4",
+  "defaults": {
+    "duration": 4,
+    "transition": { "name": "fade", "duration": 0.5 }
+  },
+  "clips": [
+    {
+      "duration": 3,
+      "layers": [{ "type": "title-background", "text": "My Video", "background": { "type": "linear-gradient" } }]
+    },
+    {
+      "layers": [{ "type": "video", "path": "clip1.mp4", "cutFrom": 0, "cutTo": 10 }]
+    },
+    {
+      "layers": [
+        { "type": "image", "path": "photo.jpg" },
+        { "type": "title", "text": "Caption", "position": "bottom" }
+      ]
+    }
+  ],
+  "audioFilePath": "background.mp3",
+  "keepSourceAudio": false
+}
+```
+
+### Layer Types
+- `video` — video clip (cutFrom/cutTo for trimming)
+- `audio` — audio track
+- `image` — static image
+- `title-background` — full-screen title card with background
+- `title` — text overlay
+- `subtitle` — subtitle text
+- `gl` — WebGL shader transition/effect
+
+## Guidelines
+
+- **Remotion** — best for complex, data-driven, animated videos (dashboards, branded content, social media)
+- **Editly** — best for quick assembly (concatenation, transitions, title cards, slideshows)
+- Both require `ffmpeg` (installed automatically with this skill)
+- Remotion renders can be CPU-intensive — warn user about duration for long compositions
+- Always confirm output path before rendering to avoid overwriting
+- Use `--fast` flag with Editly for quick previews before final render

package/skills/c-weather/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: c-weather
+description: Weather forecasts and conditions — current, hourly, multi-day. No API key needed.
+tags: [weather, forecast, temperature, assistant]
+---
+
+# Weather — Forecasts & Conditions
+
+Get weather information using `curl` and wttr.in. No API key required, no tool to install.
+
+## Commands
+
+```bash
+# Current weather (auto-detects location)
+curl -s "wttr.in?format=3"
+
+# Detailed current conditions
+curl -s "wttr.in?format=%l:+%c+%t+%h+%w+%p"
+
+# Full forecast (today + 2 days)
+curl -s "wttr.in"
+
+# Specific city
+curl -s "wttr.in/London"
+curl -s "wttr.in/New+York"
+curl -s "wttr.in/Tokyo"
+
+# Compact one-line
+curl -s "wttr.in/Paris?format=%l:+%c+%t+(feels+like+%f)+%h+humidity+%w+wind"
+
+# Today only
+curl -s "wttr.in/Berlin?1"
+
+# JSON output for parsing
+curl -s "wttr.in/London?format=j1"
+
+# Moon phase
+curl -s "wttr.in/Moon"
+```
+
+## Format Codes
+
+| Code | Meaning |
+|------|---------|
+| `%c` | Weather icon |
+| `%t` | Temperature |
+| `%f` | Feels like |
+| `%h` | Humidity |
+| `%w` | Wind |
+| `%p` | Precipitation |
+| `%l` | Location |
+| `%S` | Sunrise |
+| `%s` | Sunset |
+
+## Guidelines
+
+- Default to the user's location (check memory/SOUL.md for city)
+- Use compact format (`format=3`) for quick checks
+- Use full output for detailed forecasts
+- If the user asks about weather, always provide temperature and conditions
+- Mention "feels like" temperature when it differs significantly

package/dist/permissions-CoaVX2ZM.js

@@ -1,3 +0,0 @@
-import { addPermissions, getPermissionRule, readSettings, removePermissions, writeSettings } from "./permissions-BHOAvP8i.js";
-
-export { writeSettings };