pawmode 1.0.0

package/dist/permissions-BHOAvP8i.js

@@ -0,0 +1,55 @@
+import os from "node:os";
+import fs from "node:fs";
+import path from "node:path";
+
+//#region src/core/permissions.ts
+const SETTINGS_PATH = path.join(os.homedir(), ".claude", "settings.json");
+function readSettings() {
+	try {
+		if (!fs.existsSync(SETTINGS_PATH)) return {};
+		const content = fs.readFileSync(SETTINGS_PATH, "utf8");
+		return JSON.parse(content);
+	} catch {
+		return {};
+	}
+}
+function writeSettings(settings) {
+	const dir = path.dirname(SETTINGS_PATH);
+	fs.mkdirSync(dir, { recursive: true });
+	const tmpPath = `${SETTINGS_PATH}.tmp`;
+	fs.writeFileSync(tmpPath, JSON.stringify(settings, null, 2) + "\n", "utf8");
+	fs.renameSync(tmpPath, SETTINGS_PATH);
+}
+function getPermissionRule(tool) {
+	return `Bash(${tool.command} *)`;
+}
+function addPermissions(tools) {
+	const settings = readSettings();
+	if (!settings.permissions) settings.permissions = {};
+	if (!Array.isArray(settings.permissions.allow)) settings.permissions.allow = [];
+	const existing = new Set(settings.permissions.allow);
+	const added = [];
+	for (const tool of tools) {
+		const rule = getPermissionRule(tool);
+		if (!existing.has(rule)) {
+			settings.permissions.allow.push(rule);
+			existing.add(rule);
+			added.push(rule);
+		}
+	}
+	if (added.length > 0) writeSettings(settings);
+	return added;
+}
+function removePermissions(tools) {
+	const settings = readSettings();
+	if (!settings.permissions?.allow) return [];
+	const toRemove = new Set(tools.map(getPermissionRule));
+	const before = settings.permissions.allow.length;
+	settings.permissions.allow = settings.permissions.allow.filter((rule) => !toRemove.has(rule));
+	const removed = before - settings.permissions.allow.length;
+	if (removed > 0) writeSettings(settings);
+	return tools.map(getPermissionRule).filter((r) => toRemove.has(r));
+}
+
+//#endregion
+export { addPermissions, getPermissionRule, readSettings, removePermissions, writeSettings };

package/dist/permissions-CoaVX2ZM.js

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

package/dist/skills-CJ_pyPlv.js

@@ -0,0 +1,53 @@
+import os from "node:os";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+//#region src/core/skills.ts
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+function getDefaultSkillsDir() {
+	return path.join(os.homedir(), ".claude", "skills");
+}
+function getSkillTemplatePath(skillId) {
+	const candidates = [
+		path.resolve(__dirname, "..", "..", "skills", `c-${skillId}`, "SKILL.md"),
+		path.resolve(__dirname, "..", "skills", `c-${skillId}`, "SKILL.md"),
+		path.resolve(__dirname, "skills", `c-${skillId}`, "SKILL.md")
+	];
+	for (const candidate of candidates) if (fs.existsSync(candidate)) return candidate;
+	return candidates[0];
+}
+function getInstalledSkillPath(skillId, skillsDir) {
+	const dir = skillsDir ?? getDefaultSkillsDir();
+	return path.join(dir, `c-${skillId}`, "SKILL.md");
+}
+function isSkillInstalled(skillId, skillsDir) {
+	return fs.existsSync(getInstalledSkillPath(skillId, skillsDir));
+}
+function installSkill(skillId, skillsDir) {
+	const templatePath = getSkillTemplatePath(skillId);
+	const targetPath = getInstalledSkillPath(skillId, skillsDir);
+	if (!fs.existsSync(templatePath)) return false;
+	const targetDir = path.dirname(targetPath);
+	fs.mkdirSync(targetDir, { recursive: true });
+	fs.copyFileSync(templatePath, targetPath);
+	return true;
+}
+function removeSkill(skillId, skillsDir) {
+	const dir = skillsDir ?? getDefaultSkillsDir();
+	const skillDir = path.join(dir, `c-${skillId}`);
+	if (!fs.existsSync(skillDir)) return false;
+	fs.rmSync(skillDir, {
+		recursive: true,
+		force: true
+	});
+	return true;
+}
+function listInstalledSkills(skillsDir) {
+	const dir = skillsDir ?? getDefaultSkillsDir();
+	if (!fs.existsSync(dir)) return [];
+	return fs.readdirSync(dir).filter((name) => name.startsWith("c-") && fs.existsSync(path.join(dir, name, "SKILL.md"))).map((name) => name.replace("c-", ""));
+}
+
+//#endregion
+export { getDefaultSkillsDir, getInstalledSkillPath, getSkillTemplatePath, installSkill, isSkillInstalled, listInstalledSkills, removeSkill };

package/dist/skills-DwMXaN3R.js

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "pawmode",
+  "version": "1.0.0",
+  "description": "Open-source Personal Assistant Wizard for Claude Code. Turn Claude Code into your PA with CLI tools and skills.",
+  "type": "module",
+  "bin": {
+    "openpaw": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "scripts": {
+    "build": "tsdown && node -e \"const fs=require('fs');const f='dist/index.js';fs.writeFileSync(f,'#!/usr/bin/env node\\n'+fs.readFileSync(f,'utf8'));fs.chmodSync(f,0o755)\"",
+    "dev": "tsdown --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "personal-assistant",
+    "ai",
+    "skills",
+    "cli",
+    "wizard",
+    "openpaw",
+    "telegram"
+  ],
+  "author": "daxaur",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/daxaur/openpaw.git"
+  },
+  "homepage": "https://github.com/daxaur/openpaw",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.63",
+    "@clack/prompts": "^0.10.0",
+    "@grammyjs/hydrate": "^1.6.0",
+    "chalk": "^5.4.1",
+    "commander": "^14.0.0",
+    "gradient-string": "^3.0.0",
+    "grammy": "^1.40.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.0",
+    "@types/gradient-string": "^1.1.6",
+    "@types/node": "^22.0.0",
+    "tsdown": "^0.11.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}

package/skills/c-ai/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: c-ai
+description: Query LLMs from the CLI — pipe text for summarization, chat interactively, use local or cloud models with llm or aichat.
+tags: [ai, llm, summarize, chat]
+---
+
+# AI / LLM Tools
+
+## llm (Simon Willison)
+
+```bash
+# Quick prompt
+llm "What is the capital of France?"
+
+# Pipe text for processing
+cat article.txt | llm "Summarize this in 3 bullet points"
+git diff | llm "Write a commit message for these changes"
+pbpaste | llm "Fix the grammar in this text"
+
+# Interactive chat
+llm chat
+
+# Use specific model
+llm -m claude-3.5-sonnet "Explain quantum computing"
+llm -m gpt-4o "Review this code"
+
+# List available models
+llm models
+
+# Install model plugins
+llm install llm-claude-3
+llm install llm-ollama    # local models
+
+# View prompt/response history
+llm logs list
+llm logs last
+```
+
+## aichat
+
+```bash
+# Quick prompt
+aichat "Explain Docker in simple terms"
+
+# Pipe input
+cat code.py | aichat "Find bugs in this code"
+
+# Interactive REPL
+aichat
+
+# Shell assistant (generates and runs commands)
+aichat -e "find all files larger than 100MB"
+
+# Specific model
+aichat -m claude-3.5-sonnet "Hello"
+
+# List models
+aichat --list-models
+```
+
+## Guidelines
+
+- Use `llm` for piping text through LLMs (summarize, translate, analyze)
+- Use `aichat -e` for generating shell commands from natural language
+- Both tools store API keys locally — set up once with auth commands
+- `llm` has the richest plugin ecosystem (100+ model providers)
+- `aichat` is faster (Rust) and has built-in RAG support
+- These tools use separate API keys from Claude Code — user pays per token

package/skills/c-apps/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: c-apps
+description: Install, update, and search Mac App Store apps from the command line using mas.
+tags: [apps, appstore, macos, install]
+---
+
+# Mac App Store (mas)
+
+```bash
+# Search for apps
+mas search Xcode
+mas search "Bear Notes"
+
+# Install by app ID
+mas install 497799835    # Xcode
+
+# List installed apps
+mas list
+
+# Check for outdated apps
+mas outdated
+
+# Upgrade all outdated apps
+mas upgrade
+
+# Upgrade specific app
+mas upgrade 497799835
+
+# Show app info
+mas info 497799835
+
+# Open app page in App Store
+mas open 497799835
+```
+
+## Guidelines
+
+- User must be signed into the Mac App Store
+- On macOS 15+, install/upgrade requires admin password
+- Use `mas search` to find app IDs before installing
+- `mas upgrade` updates all apps — confirm with user first
+- Free and paid apps both work (paid requires prior purchase)

package/skills/c-bluetooth/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: c-bluetooth
+description: Manage Bluetooth devices on macOS using the blucli (`blu`) CLI. List paired and available devices, connect to headphones/speakers/keyboards, and disconnect devices by name or MAC address.
+tags: [bluetooth, hardware, macos, devices, audio]
+---
+
+## What This Skill Does
+
+Manages Bluetooth device connections on macOS using `blu` (blucli). You can list available devices, connect to a device by name or MAC address, and disconnect active devices.
+
+## CLI Tool: `blu`
+
+### Common Commands
+
+```bash
+# List all paired/known devices
+blu list
+
+# Connect to a device (by name or MAC)
+blu connect "AirPods Pro"
+blu connect AA:BB:CC:DD:EE:FF
+
+# Disconnect a device
+blu disconnect "AirPods Pro"
+blu disconnect AA:BB:CC:DD:EE:FF
+
+# Check connection status
+blu status
+```
+
+## Usage Guidelines
+
+1. Run `blu list` first to identify the exact device name or MAC address.
+2. Device names are case-sensitive — use the exact name from `blu list`.
+3. If connecting by name fails, fall back to MAC address.
+4. After connecting, confirm success by checking for a non-error exit code or running `blu status`.
+
+## Notes
+
+- `blu` only manages already-paired devices. New device pairing must be done via macOS System Settings.
+- Some commands may require Bluetooth to be enabled in macOS before running.
+- If `blu` is not installed: `brew install blucli`

package/skills/c-briefing/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: c-briefing
+description: Daily briefing — morning summary of email, calendar, tasks, weather. Can run on a schedule via launchd/cron.
+tags: [briefing, daily, morning, summary, schedule]
+---
+
+# Daily Briefing
+
+Compile a morning summary from your installed skills. Checks what's available and builds the briefing accordingly.
+
+## What to Include
+
+Check which skills are installed and pull from each:
+
+| If installed | Include in briefing |
+|---|---|
+| c-email | Unread email count + top 5 subjects |
+| c-calendar | Today's events + tomorrow preview |
+| c-tasks | Due today + overdue items |
+| c-notes | Recently modified notes |
+| c-github | Open PRs, review requests, CI failures |
+| c-slack | Unread DM count + mentions |
+| c-tracking | Package delivery updates |
+
+## Briefing Format
+
+```
+Good morning, {name}! Here's your briefing for {date}:
+
+📧 Email: 12 unread — 3 flagged
+  → "Q4 Budget Review" from Sarah
+  → "Deploy approval needed" from CI Bot
+  → "Lunch tomorrow?" from Mike
+
+📅 Calendar:
+  → 9:00 AM  Team standup (30 min)
+  → 11:00 AM  1:1 with Alex (45 min)
+  → 2:00 PM  Sprint review (1 hr)
+
+✅ Tasks: 3 due today, 1 overdue
+  → [overdue] Fix login bug
+  → Write API docs
+  → Review PR #234
+
+🔔 Other:
+  → 2 GitHub PRs need review
+  → Package arriving today (Amazon)
+```
+
+## Scheduled Briefing
+
+To run automatically each morning, set up a launchd job (macOS) or cron job:
+
+```bash
+# Create a briefing script
+cat > ~/.claude/briefing.sh << 'SCRIPT'
+#!/bin/bash
+claude --print "Run my daily briefing using the c-briefing skill. Be concise." \
+  | terminal-notifier -title "Morning Briefing" -message "Ready" 2>/dev/null
+SCRIPT
+chmod +x ~/.claude/briefing.sh
+
+# Schedule with cron (every weekday at 8:00 AM)
+(crontab -l 2>/dev/null; echo "0 8 * * 1-5 ~/.claude/briefing.sh") | crontab -
+
+# Or use lunchy-go for launchd (macOS)
+lunchy-go install ~/.claude/briefing.plist
+```
+
+## Manual Briefing
+
+Just ask Claude: "Give me my daily briefing" or "What's on my plate today?"
+
+## Guidelines
+
+- Read the user's name from SOUL.md or MEMORY.md
+- Only include sections for skills that are actually installed
+- Keep it concise — no section should exceed 5 items
+- Flag urgent items at the top
+- Include the date and day of week

package/skills/c-browser/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: c-browser
+description: Headless browser automation — navigate pages, click elements, fill forms, take screenshots, scrape content using agent-browser or playwright-cli.
+tags: [browser, automation, scraping, web]
+---
+
+# Browser Automation
+
+## agent-browser (Vercel)
+
+Navigate and interact with web pages using structured snapshots:
+
+```bash
+# Open a URL
+agent-browser open "https://example.com"
+
+# Get interactive element snapshot (shows clickable refs)
+agent-browser snapshot -i
+
+# Click an element by ref
+agent-browser click @e2
+
+# Fill a form field
+agent-browser fill @e5 "search query"
+
+# Take annotated screenshot
+agent-browser screenshot --annotate
+
+# Type text
+agent-browser type "hello world"
+
+# Press keys
+agent-browser press Enter
+```
+
+## playwright-cli (Microsoft)
+
+Token-efficient browser automation designed for AI agents:
+
+```bash
+# Install browser (first time)
+playwright-cli install-browser
+
+# Navigate to URL
+playwright-cli navigate "https://example.com"
+
+# Get page snapshot
+playwright-cli snapshot
+
+# Click element
+playwright-cli click "Submit button"
+
+# Fill input
+playwright-cli fill "Search" "query text"
+
+# Screenshot
+playwright-cli screenshot
+```
+
+## Guidelines
+
+- Use agent-browser for AI-driven web interaction (snapshot-ref pattern)
+- Use playwright-cli for structured automation and testing flows
+- Always check snapshots before clicking — element refs change between pages
+- For login flows, navigate step by step and verify each page loads
+- Respect robots.txt and rate limits when scraping

package/skills/c-calendar/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: c-calendar
+description: View and create calendar events via gog (Google Calendar) or icalpal (Apple Calendar). Check availability, list upcoming events, create/update/delete events, and manage multiple calendars.
+tags: [calendar, google-calendar, apple-calendar, gog, icalpal, events]
+---
+
+This skill manages calendars via `gog` (Google Calendar) or `icalpal` (Apple Calendar). Check availability with `which gog icalpal`.
+
+## Google Calendar — `gog cal` (gogcli)
+
+```bash
+gog cal list                               # List upcoming events
+gog cal list --days 7                      # Next 7 days
+gog cal list --calendar "Work"             # Specific calendar
+gog cal list --start "2026-03-01" --end "2026-03-07"
+gog cal get <event-id>                     # Get event details
+gog cal create --title "Meeting" --start "2026-03-01T10:00" --end "2026-03-01T11:00"
+gog cal create --title "Event" --start "tomorrow 2pm" --duration 1h --calendar "Work"
+gog cal create --attendees "alice@x.com,bob@x.com" --title "Sync"
+gog cal update <event-id> --title "New Title"
+gog cal delete <event-id>
+gog cal calendars                          # List all calendars
+gog cal freebusy --start "tomorrow" --end "tomorrow 5pm"
+```
+
+## Apple Calendar — `icalpal`
+
+```bash
+icalpal events                             # Today's events
+icalpal events --from "2026-03-01" --to "2026-03-07"
+icalpal events --calendar "Work"
+icalpal calendars                          # List all calendars/accounts
+icalpal reminders                          # List calendar-based reminders
+```
+
+## Usage Guidelines
+
+- Use `gog cal freebusy` to check availability before scheduling.
+- `icalpal` is read-only for Apple Calendar — use it for viewing, not creating.
+- For creating Apple Calendar events programmatically, prefer `gog` with Google Calendar or use AppleScript via the `osascript` fallback.
+- Dates accept natural language with `gog` ("tomorrow 2pm", "next Monday 9am").
+
+## Notes
+
+- `gog` requires Google OAuth: `gog auth`.
+- `icalpal` reads directly from the local Calendar database (no auth needed).
+- Multiple Google accounts supported via `gog cal --account work list`.

package/skills/c-core/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: c
+description: OpenPaw coordinator — routes requests to skills, manages memory, knows what's installed. Use /c for any task.
+tags: [coordinator, routing, skills, meta, openpaw]
+---
+
+# OpenPaw — Personal Assistant Coordinator
+
+You are powered by **OpenPaw**, an open-source personal assistant system for Claude Code. You have access to CLI tools and skills that let you control apps, services, and system features.
+
+## PAW MODE Active
+
+You are running in **PAW MODE** — full personal assistant mode powered by OpenPaw.
+
+- Greet the user by name (check SOUL.md)
+- At the start of each session, briefly acknowledge PAW MODE (e.g., "PAW MODE active, ready to help! 🐾")
+- Proactively help with tasks when appropriate
+- If asked about your mode: "I'm in PAW MODE — your personal assistant is ready"
+
+## Session Start Checklist
+
+1. Read `~/.claude/SOUL.md` if it exists — this defines your personality and the user's preferences
+2. Read `~/.claude/memory/MEMORY.md` if it exists — this has persistent facts and context
+3. Check `ls ~/.claude/skills/` to see what skills are installed
+
+## Memory
+
+- Save important facts to `~/.claude/memory/MEMORY.md` when the user shares them
+- Log session summaries to `~/.claude/memory/journal.md`
+- Track people in `~/.claude/memory/people.md`
+- Track preferences in `~/.claude/memory/preferences.md`
+
+## Available Skills
+
+| Skill | Purpose |
+|---|---|
+| c-memory | Persistent memory across sessions |
+| c-notes | Apple Notes + Reminders |
+| c-obsidian | Obsidian vault management |
+| c-notion | Notion pages/databases |
+| c-tasks | Todoist / Things / Taskwarrior |
+| c-email | Gmail / IMAP email |
+| 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 |
+| c-voice | Speech-to-text + TTS |
+| c-lights | Philips Hue |
+| c-speakers | Sonos speakers |
+| c-bluetooth | Bluetooth devices |
+| c-browser | Headless browser |
+| c-cron | Scheduled jobs |
+| c-system | macOS system control |
+| c-apps | Mac App Store |
+| c-files | Cloud file sync |
+| c-display | Brightness + trash |
+| c-notify | macOS notifications |
+| c-research | Web research + summarization |
+| c-location | Maps + nearby places |
+| c-tracking | Package tracking |
+| c-secrets | Password managers |
+| c-network | DNS + HTTP tools |
+| c-ai | Query other LLMs |
+| c-github | GitHub PRs, issues, repos |
+| c-linear | Linear issues |
+| c-jira | Jira issues |
+
+## Routing
+
+- Match the user's intent to the most specific skill
+- If multiple skills apply, use them in sequence
+- If a skill isn't installed, suggest: `openpaw add <skill-name>`
+- Check availability with `which <tool>` or `ls ~/.claude/skills/c-<name>/`
+
+## Identity
+
+- You are an OpenPaw-powered assistant
+- Open-source, no daemon, no extra cost
+- If asked about your setup: "I'm powered by OpenPaw — open-source personal assistant skills for Claude Code"
+- Project: https://github.com/daxaur/openpaw

package/skills/c-cron/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: c-cron
+description: Manage cron jobs and macOS launchctl services — schedule recurring tasks, start/stop services using lunchy-go.
+tags: [cron, scheduling, launchctl, automation]
+---
+
+# Scheduling & Cron
+
+## lunchy-go (launchctl wrapper)
+
+Friendly wrapper around macOS `launchctl`:
+
+```bash
+# List all services (pattern match)
+lunchy-go ls
+lunchy-go ls redis
+
+# Start a service
+lunchy-go start com.example.service
+lunchy-go start redis    # pattern match
+
+# Stop a service
+lunchy-go stop redis
+
+# Restart a service
+lunchy-go restart redis
+
+# Show service status
+lunchy-go status redis
+```
+
+## crontab (built-in)
+
+Standard Unix cron scheduler:
+
+```bash
+# List current cron jobs
+crontab -l
+
+# Edit cron jobs (opens editor)
+crontab -e
+
+# Cron syntax: MIN HOUR DOM MON DOW command
+# Every day at 9am:
+# 0 9 * * * /path/to/script.sh
+# Every 5 minutes:
+# */5 * * * * /path/to/script.sh
+# Weekdays at 8:30am:
+# 30 8 * * 1-5 /path/to/script.sh
+```
+
+## Guidelines
+
+- Prefer lunchy-go for macOS services (launchd plists)
+- Use crontab for simple recurring commands
+- Always use full paths in cron jobs
+- Redirect output to log files: `command >> /tmp/cron.log 2>&1`
+- Test commands manually before scheduling them