Single fast-execution skill for macOS / Linux / Windows app operations. The "cerebellum" to the LLM's "cerebrum" — the brain decides intent, this skill executes the canonical multi-step pattern in one syscall sequence (no LLM round-trip per step). Inspired by the same architecture as the LocalKin robot car: the high-level brain plans ("rename this file to X"), the cerebellum daemon executes deterministically (`mv old new`) at near-zero latency. USAGE: cerebellum "<category> <action> [args...]" Categories: macOS finder, notes, mail, calendar, reminders, settings, safari, music, photos, maps, pages, numbers, keynote, terminal, multi, web (16 cats, 478 actions) Linux linux-files, linux-apps, linux-settings, linux-clipboard (4 cats) Windows windows-files, windows-apps, windows-settings, windows-clipboard (4 cats) Run with no args to see the full action menu. Examples: cerebell
Get the user's current GPS location. Auto-detects the best backend for the host OS: macOS → corelocationcli (CoreLocation — cell / WiFi / GPS) Linux → gdbus + geoclue2 (kernel-driver / WiFi / Mozilla MLS) fallback → IP geolocation (ipapi.co — city-level only) Returns coordinates / address / city / full details — request what you need with the `format` arg. When to use this vs the {{location}} system prompt context: - {{location}} is set from $KINCLAW_LOCATION env var — "where the user generally is" (home / office). Static, free, always available. - This skill reads the OS location service in real time — "where the user is right NOW". Use when user might be traveling / driving / out, or when meter-level precision matters. First invocation prompts for permission (macOS Location Services / Linux Geoclue per-app authorization through xdg-desktop-portal). Grant it for whichever process kinclaw runs in. First-time setup: macOS: brew install corelocationcli Linux: apt install
Create a Mail draft (saved, not sent) with subject + body and an optional attachment. Uses Mail's AppleScript dictionary directly: `make new outgoing message` then `save` (NOT `send`). The draft appears in the Drafts mailbox of the default account. This is the CORRECT path for any task that says "save as Mail draft" / "share via Mail as draft". Common wrong path: agents open a compose window with Cmd+N, type subject + body, then close with Cmd+W — that prompts a Save sheet they often skip, losing the draft. This skill bypasses the compose window entirely.
Attach an image file to a Notes note. Notes' AppleScript dictionary does NOT support `make new attachment` for image files, so this skill uses the clipboard-paste path: 1. Read the image into the system pasteboard via `osascript`'s `(read POSIX file "X" as JPEG picture)` coercion (works for JPEG / PNG / TIFF — checks file extension). 2. Activate Notes, select the target note, focus the body. 3. Move cursor to end of body, then Cmd+V — Notes pastes a pasteboard image as an attachment in the note. This is more robust than the Edit-menu "Attach File" UI flow, which opens a file picker that's brittle to AX-walk.
Convert a note's body into a Notes-native checklist (HTML `<ul class="gtl-todo-list">` markup), with optional auto-checking of specific item indices. Agents routinely fail at this by typing markdown `- [ ]` text — Notes does NOT recognize markdown checklist syntax; it stores literal "- [ ]" text. The native checklist requires Cmd+Shift+L on selected text or Format menu → Checklist. This skill: activates Notes, focuses the note body, selects all, Cmd+Shift+L to convert. If `check_indices` is given, navigates to each line and presses Cmd+Shift+U to toggle the checkbox.
Export a Notes note to a PDF file at an absolute path. Notes doesn't expose Export-as-PDF via AppleScript dictionary; this skill drives the File menu + Save sheet via UI scripting. The Save sheet is the standard NSSavePanel — we type the filename into the focused field, use Cmd+Shift+G to set the destination directory, then press Return to commit. The skill does NOT use the Print → Save as PDF route (3+ extra dialog clicks); it uses Notes' direct File → Export as PDF... menu. After the save, the skill polls for the file's existence to confirm completion before returning.
Apply a Notes-app text format (bold / italic / underline / title / heading / subheading / body) to text in a note. Handles selection + format keystroke + verification. The #1 mistake agents make: pressing Cmd+B without selecting text first. Notes' format shortcuts only act on the current selection; no selection = no-op. This skill always selects first.
Move a note (by exact title match) into a Notes folder (by exact folder name). Pure AppleScript — no UI scripting, no flakiness. The folder must already exist; create it with osascript or via the Notes UI before calling this skill. Why a skill (not raw shell osascript): models routinely emit the wrong AppleScript syntax for `move`, hit "Can't make ... into type specifier" errors, or move into the wrong account's folder. This skill encapsulates the canonical pattern + cross-account search.