clawdbot 2026.1.4-1

package/package.json

@@ -0,0 +1,186 @@
+{
+  "name": "clawdbot",
+  "version": "2026.1.4-1",
+  "description": "WhatsApp gateway CLI (Baileys web) with Pi RPC agent",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "clawdbot": "dist/index.js"
+  },
+  "files": [
+    "dist/agents/**",
+    "dist/auto-reply/**",
+    "dist/browser/**",
+    "dist/canvas-host/**",
+    "dist/cli/**",
+    "dist/commands/**",
+    "dist/config/**",
+    "dist/control-ui/**",
+    "dist/cron/**",
+    "dist/daemon/**",
+    "dist/discord/**",
+    "dist/gateway/**",
+    "dist/hooks/**",
+    "dist/imessage/**",
+    "dist/infra/**",
+    "dist/macos/**",
+    "dist/media/**",
+    "dist/process/**",
+    "dist/providers/**",
+    "dist/sessions/**",
+    "dist/signal/**",
+    "dist/slack/**",
+    "dist/telegram/**",
+    "dist/tui/**",
+    "dist/web/**",
+    "dist/wizard/**",
+    "dist/*.js",
+    "dist/*.json",
+    "docs/**",
+    "skills/**",
+    "README.md",
+    "README-header.png",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "docs:list": "tsx scripts/docs-list.ts",
+    "docs:dev": "cd docs && mint dev",
+    "docs:build": "cd docs && mint broken-links",
+    "build": "tsc -p tsconfig.json && tsx scripts/canvas-a2ui-copy.ts",
+    "release:check": "tsx scripts/release-check.ts",
+    "ui:install": "pnpm -C ui install",
+    "ui:dev": "pnpm -C ui dev",
+    "ui:build": "pnpm -C ui build",
+    "start": "tsx src/index.ts",
+    "clawdbot": "tsx src/index.ts",
+    "gateway:watch": "tsx watch --clear-screen=false --include 'src/**/*.ts' src/index.ts gateway --force",
+    "clawdbot:rpc": "tsx src/index.ts agent --mode rpc --json",
+    "lint": "biome check src test && oxlint --type-aware src test --ignore-pattern src/canvas-host/a2ui/a2ui.bundle.js",
+    "lint:swift": "swiftlint lint --config .swiftlint.yml && (cd apps/ios && swiftlint lint --config .swiftlint.yml)",
+    "lint:fix": "biome check --write --unsafe src && biome format --write src",
+    "format": "biome format src",
+    "format:swift": "swiftformat --lint --config .swiftformat apps/macos/Sources apps/ios/Sources apps/shared/ClawdbotKit/Sources",
+    "format:fix": "biome format src --write",
+    "test": "vitest",
+    "test:force": "tsx scripts/test-force.ts",
+    "test:coverage": "vitest run --coverage",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "protocol:gen": "tsx scripts/protocol-gen.ts",
+    "protocol:gen:swift": "tsx scripts/protocol-gen-swift.ts",
+    "protocol:check": "pnpm protocol:gen && pnpm protocol:gen:swift && git diff --exit-code -- dist/protocol.schema.json apps/macos/Sources/ClawdbotProtocol/GatewayModels.swift",
+    "canvas:a2ui:bundle": "bash scripts/bundle-a2ui.sh"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "packageManager": "pnpm@10.23.0",
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "@grammyjs/transformer-throttler": "^1.2.1",
+    "@homebridge/ciao": "^1.3.4",
+    "@mariozechner/pi-agent-core": "^0.32.3",
+    "@mariozechner/pi-ai": "^0.32.3",
+    "@mariozechner/pi-coding-agent": "^0.32.3",
+    "@mariozechner/pi-tui": "^0.32.3",
+    "@slack/bolt": "^4.5.0",
+    "@slack/web-api": "^7.11.1",
+    "@sinclair/typebox": "0.34.46",
+    "@whiskeysockets/baileys": "7.0.0-rc.9",
+    "ajv": "^8.17.1",
+    "body-parser": "^2.2.1",
+    "chalk": "^5.6.2",
+    "chokidar": "^5.0.0",
+    "chromium-bidi": "12.0.1",
+    "commander": "^14.0.2",
+    "croner": "^9.1.0",
+    "detect-libc": "^2.1.2",
+    "discord-api-types": "^0.38.33",
+    "discord.js": "^14.25.1",
+    "dotenv": "^17.2.3",
+    "express": "^5.2.1",
+    "file-type": "^21.2.0",
+    "grammy": "^1.39.2",
+    "json5": "^2.2.3",
+    "long": "5.3.2",
+    "playwright-core": "1.57.0",
+    "qrcode-terminal": "^0.12.0",
+    "sharp": "^0.34.5",
+    "tslog": "^4.10.2",
+    "undici": "^7.16.0",
+    "ws": "^8.18.3",
+    "zod": "^4.3.4"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.10",
+    "@lit-labs/signals": "^0.2.0",
+    "@lit/context": "^1.1.6",
+    "@mariozechner/mini-lit": "0.2.1",
+    "@types/body-parser": "^1.19.6",
+    "@types/express": "^5.0.6",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^25.0.3",
+    "@types/qrcode-terminal": "^0.12.2",
+    "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^4.0.16",
+    "docx-preview": "^0.3.7",
+    "jszip": "^3.10.1",
+    "lit": "^3.3.2",
+    "lucide": "^0.562.0",
+    "markdown-it": "^14.1.0",
+    "ollama": "^0.6.3",
+    "oxlint": "^1.36.0",
+    "oxlint-tsgolint": "^0.10.1",
+    "quicktype-core": "^23.2.6",
+    "rolldown": "1.0.0-beta.58",
+    "signal-utils": "^0.21.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16",
+    "wireit": "^0.14.12"
+  },
+  "pnpm": {
+    "overrides": {
+      "@sinclair/typebox": "0.34.46"
+    },
+    "patchedDependencies": {
+      "@mariozechner/pi-ai": "patches/@mariozechner__pi-ai.patch"
+    }
+  },
+  "vitest": {
+    "coverage": {
+      "provider": "v8",
+      "reporter": [
+        "text",
+        "lcov"
+      ],
+      "thresholds": {
+        "lines": 70,
+        "functions": 70,
+        "branches": 70,
+        "statements": 70
+      },
+      "include": [
+        "src/**/*.ts"
+      ],
+      "exclude": [
+        "src/**/*.test.ts"
+      ]
+    },
+    "include": [
+      "src/**/*.test.ts"
+    ],
+    "exclude": [
+      "dist/**",
+      "apps/macos/**",
+      "apps/macos/.build/**",
+      "**/vendor/**",
+      "apps/macos/.build/**",
+      "dist/Clawdbot.app/**"
+    ]
+  }
+}

package/skills/apple-notes/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: apple-notes
+description: Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks Clawdbot to add a note, list notes, search notes, or manage note folders.
+homepage: https://github.com/antoniorodr/memo
+metadata: {"clawdbot":{"emoji":"📝","os":["darwin"],"requires":{"bins":["memo"]},"install":[{"id":"brew","kind":"brew","formula":"antoniorodr/memo/memo","bins":["memo"],"label":"Install memo via Homebrew"}]}}
+---
+
+# Apple Notes CLI
+
+Use `memo notes` to manage Apple Notes directly from the terminal. Create, view, edit, delete, search, move notes between folders, and export to HTML/Markdown.
+
+Setup
+- Install (Homebrew): `brew tap antoniorodr/memo && brew install antoniorodr/memo/memo`
+- Manual (pip): `pip install .` (after cloning the repo)
+- macOS-only; if prompted, grant Automation access to Notes.app.
+
+View Notes
+- List all notes: `memo notes`
+- Filter by folder: `memo notes -f "Folder Name"`
+- Search notes (fuzzy): `memo notes -s "query"`
+
+Create Notes
+- Add a new note: `memo notes -a`
+  - Opens an interactive editor to compose the note.
+- Quick add with title: `memo notes -a "Note Title"`
+
+Edit Notes
+- Edit existing note: `memo notes -e`
+  - Interactive selection of note to edit.
+
+Delete Notes
+- Delete a note: `memo notes -d`
+  - Interactive selection of note to delete.
+
+Move Notes
+- Move note to folder: `memo notes -m`
+  - Interactive selection of note and destination folder.
+
+Export Notes
+- Export to HTML/Markdown: `memo notes -ex`
+  - Exports selected note; uses Mistune for markdown processing.
+
+Limitations
+- Cannot edit notes containing images or attachments.
+- Interactive prompts may require terminal access.
+
+Notes
+- macOS-only.
+- Requires Apple Notes.app to be accessible.
+- For automation, grant permissions in System Settings > Privacy & Security > Automation.

package/skills/apple-reminders/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: apple-reminders
+description: Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
+homepage: https://github.com/steipete/remindctl
+metadata: {"clawdbot":{"emoji":"⏰","os":["darwin"],"requires":{"bins":["remindctl"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/remindctl","bins":["remindctl"],"label":"Install remindctl via Homebrew"}]}}
+---
+
+# Apple Reminders CLI (remindctl)
+
+Use `remindctl` to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.
+
+Setup
+- Install (Homebrew): `brew install steipete/tap/remindctl`
+- From source: `pnpm install && pnpm build` (binary at `./bin/remindctl`)
+- macOS-only; grant Reminders permission when prompted.
+
+Permissions
+- Check status: `remindctl status`
+- Request access: `remindctl authorize`
+
+View Reminders
+- Default (today): `remindctl`
+- Today: `remindctl today`
+- Tomorrow: `remindctl tomorrow`
+- Week: `remindctl week`
+- Overdue: `remindctl overdue`
+- Upcoming: `remindctl upcoming`
+- Completed: `remindctl completed`
+- All: `remindctl all`
+- Specific date: `remindctl 2026-01-04`
+
+Manage Lists
+- List all lists: `remindctl list`
+- Show list: `remindctl list Work`
+- Create list: `remindctl list Projects --create`
+- Rename list: `remindctl list Work --rename Office`
+- Delete list: `remindctl list Work --delete`
+
+Create Reminders
+- Quick add: `remindctl add "Buy milk"`
+- With list + due: `remindctl add --title "Call mom" --list Personal --due tomorrow`
+
+Edit Reminders
+- Edit title/due: `remindctl edit 1 --title "New title" --due 2026-01-04`
+
+Complete Reminders
+- Complete by id: `remindctl complete 1 2 3`
+
+Delete Reminders
+- Delete by id: `remindctl delete 4A83 --force`
+
+Output Formats
+- JSON (scripting): `remindctl today --json`
+- Plain TSV: `remindctl today --plain`
+- Counts only: `remindctl today --quiet`
+
+Date Formats
+Accepted by `--due` and date filters:
+- `today`, `tomorrow`, `yesterday`
+- `YYYY-MM-DD`
+- `YYYY-MM-DD HH:mm`
+- ISO 8601 (`2026-01-04T12:34:56Z`)
+
+Notes
+- macOS-only.
+- If access is denied, enable Terminal/remindctl in System Settings → Privacy & Security → Reminders.
+- If running over SSH, grant access on the Mac that runs the command.

package/skills/bear-notes/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: bear-notes
+description: Create, search, and manage Bear notes via grizzly CLI.
+homepage: https://bear.app
+metadata: {"clawdbot":{"emoji":"🐻","os":["darwin"],"requires":{"bins":["grizzly"]},"install":[{"id":"go","kind":"go","module":"github.com/tylerwince/grizzly/cmd/grizzly@latest","bins":["grizzly"],"label":"Install grizzly (go)"}]}}
+---
+
+# Bear Notes
+
+Use `grizzly` to create, read, and manage notes in Bear on macOS.
+
+Requirements
+- Bear app installed and running
+- For some operations (add-text, tags, open-note --selected), a Bear app token (stored in `~/.config/grizzly/token`)
+
+## Getting a Bear Token
+
+For operations that require a token (add-text, tags, open-note --selected), you need an authentication token:
+1. Open Bear → Help → API Token → Copy Token
+2. Save it: `echo "YOUR_TOKEN" > ~/.config/grizzly/token`
+
+## Common Commands
+
+Create a note
+```bash
+echo "Note content here" | grizzly create --title "My Note" --tag work
+grizzly create --title "Quick Note" --tag inbox < /dev/null
+```
+
+Open/read a note by ID
+```bash
+grizzly open-note --id "NOTE_ID" --enable-callback --json
+```
+
+Append text to a note
+```bash
+echo "Additional content" | grizzly add-text --id "NOTE_ID" --mode append --token-file ~/.config/grizzly/token
+```
+
+List all tags
+```bash
+grizzly tags --enable-callback --json --token-file ~/.config/grizzly/token
+```
+
+Search notes (via open-tag)
+```bash
+grizzly open-tag --name "work" --enable-callback --json
+```
+
+## Options
+
+Common flags:
+- `--dry-run` — Preview the URL without executing
+- `--print-url` — Show the x-callback-url
+- `--enable-callback` — Wait for Bear's response (needed for reading data)
+- `--json` — Output as JSON (when using callbacks)
+- `--token-file PATH` — Path to Bear API token file
+
+## Configuration
+
+Grizzly reads config from (in priority order):
+1. CLI flags
+2. Environment variables (`GRIZZLY_TOKEN_FILE`, `GRIZZLY_CALLBACK_URL`, `GRIZZLY_TIMEOUT`)
+3. `.grizzly.toml` in current directory
+4. `~/.config/grizzly/config.toml`
+
+Example `~/.config/grizzly/config.toml`:
+```toml
+token_file = "~/.config/grizzly/token"
+callback_url = "http://127.0.0.1:42123/success"
+timeout = "5s"
+```
+
+## Notes
+
+- Bear must be running for commands to work
+- Note IDs are Bear's internal identifiers (visible in note info or via callbacks)
+- Use `--enable-callback` when you need to read data back from Bear
+- Some operations require a valid token (add-text, tags, open-note --selected)

package/skills/bird/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: bird
+description: X/Twitter CLI for reading, searching, and posting via cookies or Sweetistics.
+homepage: https://bird.fast
+metadata: {"clawdbot":{"emoji":"🐦","requires":{"bins":["bird"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/bird","bins":["bird"],"label":"Install bird (brew)"}]}}
+---
+
+# bird
+
+Use `bird` to read/search X and post tweets/replies.
+
+Quick start
+- `bird whoami`
+- `bird read <url-or-id>`
+- `bird thread <url-or-id>`
+- `bird search "query" -n 5`
+
+Posting (confirm with user first)
+- `bird tweet "text"`
+- `bird reply <id-or-url> "text"`
+
+Auth sources
+- Browser cookies (default: Firefox/Chrome)
+- Sweetistics API: set `SWEETISTICS_API_KEY` or use `--engine sweetistics`
+- Check sources: `bird check`

package/skills/blogwatcher/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: blogwatcher
+description: Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.
+homepage: https://github.com/Hyaxia/blogwatcher
+metadata: {"clawdbot":{"emoji":"📰","requires":{"bins":["blogwatcher"]},"install":[{"id":"go","kind":"go","module":"github.com/Hyaxia/blogwatcher/cmd/blogwatcher@latest","bins":["blogwatcher"],"label":"Install blogwatcher (go)"}]}}
+---
+
+# blogwatcher
+
+Track blog and RSS/Atom feed updates with the `blogwatcher` CLI.
+
+Install
+- Go: `go install github.com/Hyaxia/blogwatcher/cmd/blogwatcher@latest`
+
+Quick start
+- `blogwatcher --help`
+
+Common commands
+- Add a blog: `blogwatcher add "My Blog" https://example.com`
+- List blogs: `blogwatcher blogs`
+- Scan for updates: `blogwatcher scan`
+- List articles: `blogwatcher articles`
+- Mark an article read: `blogwatcher read 1`
+- Mark all articles read: `blogwatcher read-all`
+- Remove a blog: `blogwatcher remove "My Blog"`
+
+Example output
+```
+$ blogwatcher blogs
+Tracked blogs (1):
+
+  xkcd
+    URL: https://xkcd.com
+```
+```
+$ blogwatcher scan
+Scanning 1 blog(s)...
+
+  xkcd
+    Source: RSS | Found: 4 | New: 4
+
+Found 4 new article(s) total!
+```
+
+Notes
+- Use `blogwatcher <command> --help` to discover flags and options.

package/skills/blucli/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: blucli
+description: BluOS CLI (blu) for discovery, playback, grouping, and volume.
+homepage: https://blucli.sh
+metadata: {"clawdbot":{"emoji":"🫐","requires":{"bins":["blu"]},"install":[{"id":"go","kind":"go","module":"github.com/steipete/blucli/cmd/blu@latest","bins":["blu"],"label":"Install blucli (go)"}]}}
+---
+
+# blucli (blu)
+
+Use `blu` to control Bluesound/NAD players.
+
+Quick start
+- `blu devices` (pick target)
+- `blu --device <id> status`
+- `blu play|pause|stop`
+- `blu volume set 15`
+
+Target selection (in priority order)
+- `--device <id|name|alias>`
+- `BLU_DEVICE`
+- config default (if set)
+
+Common tasks
+- Grouping: `blu group status|add|remove`
+- TuneIn search/play: `blu tunein search "query"`, `blu tunein play "query"`
+
+Prefer `--json` for scripts. Confirm the target device before changing playback.

package/skills/brave-search/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: brave-search
+description: Web search and content extraction via Brave Search API.
+homepage: https://brave.com/search/api
+metadata: {"clawdbot":{"emoji":"🦁","requires":{"bins":["node"],"env":["BRAVE_API_KEY"]},"primaryEnv":"BRAVE_API_KEY"}}
+---
+
+# Brave Search
+
+Headless web search (and lightweight content extraction) using Brave Search API. No browser required.
+
+## Search
+
+```bash
+node {baseDir}/scripts/search.mjs "query"
+node {baseDir}/scripts/search.mjs "query" -n 10
+node {baseDir}/scripts/search.mjs "query" --content
+node {baseDir}/scripts/search.mjs "query" -n 3 --content
+```
+
+## Extract a page
+
+```bash
+node {baseDir}/scripts/content.mjs "https://example.com/article"
+```
+
+Notes:
+- Needs `BRAVE_API_KEY`.
+- Content extraction is best-effort (good for articles; not for app-like sites).
+- If a site is blocked or too JS-heavy, prefer the `summarize` skill (it can use a Firecrawl fallback).

package/skills/brave-search/scripts/content.mjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+function usage() {
+  console.error(`Usage: content.mjs <url>`);
+  process.exit(2);
+}
+
+export async function fetchAsMarkdown(url) {
+  const resp = await fetch(url, {
+    headers: { "User-Agent": "clawdbot-brave-search/1.0" },
+  });
+  const html = await resp.text();
+
+  // Very lightweight “readability-ish” extraction without dependencies:
+  // - drop script/style/nav/footer
+  // - strip tags
+  // - keep paragraphs
+  const cleaned = html
+    .replace(/<script[\s\S]*?<\/script>/gi, " ")
+    .replace(/<style[\s\S]*?<\/style>/gi, " ")
+    .replace(/<(nav|footer|header)[\s\S]*?<\/\1>/gi, " ")
+    .replace(/<br\s*\/?>/gi, "\n")
+    .replace(/<\/p>/gi, "\n\n")
+    .replace(/<\/div>/gi, "\n")
+    .replace(/<[^>]+>/g, " ")
+    .replace(/&nbsp;/g, " ")
+    .replace(/&amp;/g, "&")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, '"')
+    .replace(/&#39;/g, "'")
+    .replace(/\s+\n/g, "\n")
+    .replace(/\n{3,}/g, "\n\n")
+    .replace(/[ \t]{2,}/g, " ")
+    .trim();
+
+  if (!resp.ok) {
+    return `> Fetch failed (${resp.status}).\n\n${cleaned.slice(0, 2000)}\n`;
+  }
+
+  const paras = cleaned
+    .split("\n\n")
+    .map((p) => p.trim())
+    .filter(Boolean)
+    .slice(0, 30);
+
+  return paras.map((p) => `- ${p}`).join("\n") + "\n";
+}
+
+const args = process.argv.slice(2);
+if (args.length === 0 || args[0] === "-h" || args[0] === "--help") usage();
+const url = args[0];
+process.stdout.write(await fetchAsMarkdown(url));

package/skills/brave-search/scripts/search.mjs

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+
+function usage() {
+  console.error(`Usage: search.mjs "query" [-n 5] [--content]`);
+  process.exit(2);
+}
+
+const args = process.argv.slice(2);
+if (args.length === 0 || args[0] === "-h" || args[0] === "--help") usage();
+
+const query = args[0];
+let n = 5;
+let withContent = false;
+
+for (let i = 1; i < args.length; i++) {
+  const a = args[i];
+  if (a === "-n") {
+    n = Number.parseInt(args[i + 1] ?? "5", 10);
+    i++;
+    continue;
+  }
+  if (a === "--content") {
+    withContent = true;
+    continue;
+  }
+  console.error(`Unknown arg: ${a}`);
+  usage();
+}
+
+const apiKey = (process.env.BRAVE_API_KEY ?? "").trim();
+if (!apiKey) {
+  console.error("Missing BRAVE_API_KEY");
+  process.exit(1);
+}
+
+const endpoint = new URL("https://api.search.brave.com/res/v1/web/search");
+endpoint.searchParams.set("q", query);
+endpoint.searchParams.set("count", String(Math.max(1, Math.min(n, 20))));
+endpoint.searchParams.set("text_decorations", "false");
+endpoint.searchParams.set("safesearch", "moderate");
+
+const resp = await fetch(endpoint, {
+  headers: {
+    Accept: "application/json",
+    "X-Subscription-Token": apiKey,
+  },
+});
+
+if (!resp.ok) {
+  const text = await resp.text().catch(() => "");
+  throw new Error(`Brave Search failed (${resp.status}): ${text}`);
+}
+
+const data = await resp.json();
+const results = (data?.web?.results ?? []).slice(0, n);
+
+const lines = [];
+for (const r of results) {
+  const title = String(r?.title ?? "").trim();
+  const url = String(r?.url ?? "").trim();
+  const desc = String(r?.description ?? "").trim();
+  if (!title || !url) continue;
+  lines.push(`- ${title}\n  ${url}${desc ? `\n  ${desc}` : ""}`);
+}
+
+process.stdout.write(lines.join("\n\n") + "\n");
+
+if (!withContent) process.exit(0);
+
+process.stdout.write("\n---\n\n");
+for (const r of results) {
+  const title = String(r?.title ?? "").trim();
+  const url = String(r?.url ?? "").trim();
+  if (!url) continue;
+  process.stdout.write(`# ${title || url}\n${url}\n\n`);
+  const child = await import("./content.mjs");
+  const text = await child.fetchAsMarkdown(url);
+  process.stdout.write(text.trimEnd() + "\n\n");
+}

package/skills/camsnap/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: camsnap
+description: Capture frames or clips from RTSP/ONVIF cameras.
+homepage: https://camsnap.ai
+metadata: {"clawdbot":{"emoji":"📸","requires":{"bins":["camsnap"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/camsnap","bins":["camsnap"],"label":"Install camsnap (brew)"}]}}
+---
+
+# camsnap
+
+Use `camsnap` to grab snapshots, clips, or motion events from configured cameras.
+
+Setup
+- Config file: `~/.config/camsnap/config.yaml`
+- Add camera: `camsnap add --name kitchen --host 192.168.0.10 --user user --pass pass`
+
+Common commands
+- Discover: `camsnap discover --info`
+- Snapshot: `camsnap snap kitchen --out shot.jpg`
+- Clip: `camsnap clip kitchen --dur 5s --out clip.mp4`
+- Motion watch: `camsnap watch kitchen --threshold 0.2 --action '...'`
+- Doctor: `camsnap doctor --probe`
+
+Notes
+- Requires `ffmpeg` on PATH.
+- Prefer a short test capture before longer clips.