@sulala/agent 0.1.1 → 0.1.3

package/dist/onboard.js

@@ -0,0 +1,266 @@
+/**
+ * Onboard: create ~/.sulala, default .env, and optional install daemon (launchd / systemd).
+ */
+import { mkdirSync, existsSync, writeFileSync, unlinkSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir, platform } from 'os';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** Package root (where dist/ and bin/ live). When running from dist/onboard.js this is one level up. */
+export function getPackageRoot() {
+    return join(__dirname, '..');
+}
+export function getSulalaHome() {
+    return join(homedir(), '.sulala');
+}
+const DEFAULT_ENV = `# Sulala Agent — created by sulala onboard
+# Edit and add API keys as needed. See: https://github.com/schedra/sulala
+
+PORT=3000
+HOST=127.0.0.1
+DB_PATH=./data/sulala.db
+
+# AI (uncomment and set at least one)
+# OPENAI_API_KEY=
+# OPENROUTER_API_KEY=
+# ANTHROPIC_API_KEY=
+# GOOGLE_GEMINI_API_KEY=
+# OLLAMA_BASE_URL=http://localhost:11434
+`;
+export function runOnboard() {
+    const sulalaHome = getSulalaHome();
+    const created = [];
+    if (!existsSync(sulalaHome)) {
+        mkdirSync(sulalaHome, { recursive: true });
+        created.push(sulalaHome);
+    }
+    const dataDir = join(sulalaHome, 'data');
+    if (!existsSync(dataDir)) {
+        mkdirSync(dataDir, { recursive: true });
+        created.push(dataDir);
+    }
+    const envPath = join(sulalaHome, '.env');
+    if (!existsSync(envPath)) {
+        writeFileSync(envPath, DEFAULT_ENV, 'utf8');
+        created.push(envPath);
+    }
+    return { sulalaHome, created };
+}
+function getNodePath() {
+    try {
+        return execSync('which node', { encoding: 'utf8' }).trim();
+    }
+    catch {
+        return '/usr/bin/env node';
+    }
+}
+/** Open URL in the system default browser (macOS, Linux, Windows). */
+export function openBrowser(url) {
+    const plat = platform();
+    const cmd = plat === 'darwin'
+        ? 'open'
+        : plat === 'win32'
+            ? 'start'
+            : 'xdg-open';
+    try {
+        execSync(`${cmd} "${url}"`, { stdio: 'ignore' });
+    }
+    catch {
+        console.log(`Open in browser: ${url}`);
+    }
+}
+/** Open the onboard page (optionally after a delay, e.g. after daemon start). */
+export async function openOnboardPage(opts) {
+    const port = opts.port ?? 3000;
+    const url = `http://127.0.0.1:${port}/onboard`;
+    if (opts.delayMs && opts.delayMs > 0) {
+        const plat = platform();
+        const openCmd = plat === 'darwin' ? 'open' : plat === 'win32' ? 'start' : 'xdg-open';
+        const sec = Math.max(0.5, opts.delayMs / 1000);
+        try {
+            const { spawn } = await import('child_process');
+            const child = spawn(plat === 'win32' ? 'cmd' : 'sh', plat === 'win32' ? ['/c', `timeout /t ${Math.ceil(sec)} /nobreak >nul && start ${url}`] : ['-c', `sleep ${sec}; ${openCmd} "${url}"`], { detached: true, stdio: 'ignore' });
+            child.unref();
+        }
+        catch {
+            openBrowser(url);
+        }
+    }
+    else {
+        openBrowser(url);
+    }
+}
+/** macOS: install launchd user agent so the agent runs at login and stays running. */
+function installDaemonDarwin(sulalaHome, packageRoot) {
+    const nodePath = getNodePath();
+    const entryPath = join(packageRoot, 'dist', 'index.js');
+    const plistPath = join(homedir(), 'Library', 'LaunchAgents', 'com.sulala.agent.plist');
+    const logDir = join(sulalaHome, 'logs');
+    if (!existsSync(logDir))
+        mkdirSync(logDir, { recursive: true });
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.sulala.agent</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${nodePath}</string>
+    <string>${entryPath}</string>
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${sulalaHome}</string>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${join(logDir, 'stdout.log')}</string>
+  <key>StandardErrorPath</key>
+  <string>${join(logDir, 'stderr.log')}</string>
+</dict>
+</plist>
+`;
+    mkdirSync(dirname(plistPath), { recursive: true });
+    writeFileSync(plistPath, plist, 'utf8');
+    execSync(`launchctl unload "${plistPath}" 2>/dev/null || true`, { stdio: 'ignore' });
+    execSync(`launchctl load "${plistPath}"`, { stdio: 'inherit' });
+}
+/** Linux: install systemd user service. */
+function installDaemonLinux(sulalaHome, packageRoot) {
+    const entryPath = join(packageRoot, 'dist', 'index.js');
+    const nodePath = getNodePath();
+    const unitDir = join(homedir(), '.config', 'systemd', 'user');
+    const unitPath = join(unitDir, 'sulala-agent.service');
+    const logDir = join(sulalaHome, 'logs');
+    if (!existsSync(logDir))
+        mkdirSync(logDir, { recursive: true });
+    const unit = `[Unit]
+Description=Sulala Agent
+After=network.target
+
+[Service]
+Type=simple
+WorkingDirectory=${sulalaHome}
+ExecStart=${nodePath} ${entryPath}
+Restart=on-failure
+RestartSec=5
+StandardOutput=append:${join(logDir, 'stdout.log')}
+StandardError=append:${join(logDir, 'stderr.log')}
+
+[Install]
+WantedBy=default.target
+`;
+    mkdirSync(unitDir, { recursive: true });
+    writeFileSync(unitPath, unit, 'utf8');
+    execSync('systemctl --user daemon-reload', { stdio: 'inherit' });
+    execSync('systemctl --user enable --now sulala-agent.service', { stdio: 'inherit' });
+}
+export function installDaemon() {
+    runOnboard(); // ensure ~/.sulala and .env exist
+    const sulalaHome = getSulalaHome();
+    const packageRoot = getPackageRoot();
+    const entryPath = join(packageRoot, 'dist', 'index.js');
+    if (!existsSync(entryPath)) {
+        throw new Error(`Agent entry not found: ${entryPath}. Run from an installed @sulala/agent (e.g. npm i -g @sulala/agent) or build with pnpm build.`);
+    }
+    const plat = platform();
+    if (plat === 'darwin') {
+        installDaemonDarwin(sulalaHome, packageRoot);
+        console.log('Daemon installed. Agent will run at login. Logs: ~/.sulala/logs/');
+    }
+    else if (plat === 'linux') {
+        installDaemonLinux(sulalaHome, packageRoot);
+        console.log('Daemon installed. Agent is running. Logs: ~/.sulala/logs/');
+    }
+    else {
+        throw new Error(`Daemon install is not supported on ${plat}. Use macOS or Linux.`);
+    }
+}
+/** Stop the agent daemon (does not remove it; use onboard --uninstall-daemon to remove). */
+export function stopDaemon() {
+    const plat = platform();
+    if (plat === 'darwin') {
+        const plistPath = join(homedir(), 'Library', 'LaunchAgents', 'com.sulala.agent.plist');
+        if (existsSync(plistPath)) {
+            execSync(`launchctl unload "${plistPath}"`, { stdio: 'inherit' });
+            console.log('Sulala agent stopped.');
+        }
+        else {
+            console.log('No daemon found. Agent may not be installed (sulala onboard --install-daemon).');
+        }
+    }
+    else if (plat === 'linux') {
+        const unitPath = join(homedir(), '.config', 'systemd', 'user', 'sulala-agent.service');
+        if (existsSync(unitPath)) {
+            execSync('systemctl --user stop sulala-agent.service', { stdio: 'inherit' });
+            console.log('Sulala agent stopped.');
+        }
+        else {
+            console.log('No daemon found. Agent may not be installed (sulala onboard --install-daemon).');
+        }
+    }
+    else {
+        throw new Error(`Stop is not supported on ${plat}. Use macOS or Linux.`);
+    }
+}
+/** Start the agent daemon (must be installed first with sulala onboard --install-daemon). */
+export function startDaemon() {
+    const plat = platform();
+    if (plat === 'darwin') {
+        const plistPath = join(homedir(), 'Library', 'LaunchAgents', 'com.sulala.agent.plist');
+        if (existsSync(plistPath)) {
+            execSync(`launchctl load "${plistPath}"`, { stdio: 'inherit' });
+            console.log('Sulala agent started.');
+        }
+        else {
+            console.log('No daemon found. Run: sulala onboard --install-daemon');
+        }
+    }
+    else if (plat === 'linux') {
+        const unitPath = join(homedir(), '.config', 'systemd', 'user', 'sulala-agent.service');
+        if (existsSync(unitPath)) {
+            execSync('systemctl --user start sulala-agent.service', { stdio: 'inherit' });
+            console.log('Sulala agent started.');
+        }
+        else {
+            console.log('No daemon found. Run: sulala onboard --install-daemon');
+        }
+    }
+    else {
+        throw new Error(`Start is not supported on ${plat}. Use macOS or Linux.`);
+    }
+}
+export function uninstallDaemon() {
+    const plat = platform();
+    if (plat === 'darwin') {
+        const plistPath = join(homedir(), 'Library', 'LaunchAgents', 'com.sulala.agent.plist');
+        if (existsSync(plistPath)) {
+            execSync(`launchctl unload "${plistPath}"`, { stdio: 'inherit' });
+            unlinkSync(plistPath);
+            console.log('Daemon uninstalled.');
+        }
+        else {
+            console.log('No daemon plist found.');
+        }
+    }
+    else if (plat === 'linux') {
+        const unitPath = join(homedir(), '.config', 'systemd', 'user', 'sulala-agent.service');
+        if (existsSync(unitPath)) {
+            execSync('systemctl --user stop sulala-agent.service', { stdio: 'ignore' });
+            execSync('systemctl --user disable sulala-agent.service', { stdio: 'ignore' });
+            unlinkSync(unitPath);
+            execSync('systemctl --user daemon-reload', { stdio: 'ignore' });
+            console.log('Daemon uninstalled.');
+        }
+        else {
+            console.log('No systemd unit found.');
+        }
+    }
+    else {
+        throw new Error(`Daemon uninstall is not supported on ${plat}.`);
+    }
+}
+//# sourceMappingURL=onboard.js.map

package/dist/onboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.js","sourceRoot":"","sources":["../src/onboard.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,9 +1,22 @@
 {
   "name": "@sulala/agent",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Local AI orchestration platform — file watcher, task scheduler, AI layer, plugins",
   "type": "module",
   "main": "src/index.ts",
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "gateway": "tsx src/gateway/server.ts",
+    "dashboard": "cd dashboard && npm run dev",
+    "dashboard:build": "cd dashboard && npm run build",
+    "cli": "tsx src/cli.ts",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc && cp src/db/schema.sql dist/db/",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "release:check": "npm pack --dry-run"
+  },
   "engines": {
     "node": ">=18"
   },
@@ -15,15 +28,9 @@
     "local"
   ],
   "license": "MIT",
-  "files": [
-    "dist",
-    "bin",
-    "src/db/schema.sql"
-  ],
-  "prepublishOnly": "pnpm run build",
-  "publishConfig": {
-    "access": "public"
-  },
+  "files": ["dist", "bin", "src/db/schema.sql", "registry", "context", "dashboard/dist"],
+  "prepublishOnly": "pnpm run build && pnpm run dashboard:build",
+  "publishConfig": { "access": "public" },
   "bin": {
     "sulala": "bin/sulala.mjs"
   },
@@ -52,17 +59,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
-  },
-  "scripts": {
-    "start": "tsx src/index.ts",
-    "gateway": "tsx src/gateway/server.ts",
-    "dashboard": "cd dashboard && npm run dev",
-    "dashboard:build": "cd dashboard && npm run build",
-    "cli": "tsx src/cli.ts",
-    "dev": "tsx watch src/index.ts",
-    "build": "tsc && cp src/db/schema.sql dist/db/",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint src"
   }
-}
+}

package/registry/apple-notes.md

@@ -0,0 +1,99 @@
+---
+name: apple-notes
+description: Manage Apple Notes via the `memo` CLI on macOS. Use when the user asks to add a note, list notes, search notes, or manage note folders.
+homepage: https://github.com/antoniorodr/memo
+metadata:
+  {
+    "sulala":
+      {
+        "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 note (prefer AppleScript):** For "add a note titled X", use **run_command** with `binary: "osascript"` and the AppleScript in the section below. Do not use memo for non-interactive add.
+- Add via memo (interactive only): `memo notes -a -f "FolderName"` — **requires** `-f` (folder). Opens the user's editor; memo does **not** accept title or body as arguments. Use only as fallback if osascript is unavailable.
+
+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.
+
+---
+
+## When the user asks you to add a note
+
+Your goal is to get the note into Apple Notes. Use **run_command** only (no skill-specific tools). Add osascript and memo to ALLOWED_BINARIES.
+
+**Prefer AppleScript for "add a note titled X".** Use the osascript one-liner below so the agent creates the note in one shot instead of trying memo (which is interactive and does not accept title as an argument).
+
+1. **Adding a note directly (macOS)**
+   - Use **run_command** with `binary: "osascript"` and one `-e` argument containing this AppleScript. Replace TITLE and BODY with the user's note title and optional body; escape any double-quote in TITLE or BODY as backslash-quote (`\"`).
+   - Script (use `\n` for newlines in the string you pass):
+     `tell application "Notes"\ntell account "iCloud"\ntell folder "Notes"\nmake new note with properties {name:"TITLE", body:"BODY"}\nend tell\nend tell\nend tell`
+   - Example for "add apple note called buy saisai": args = `["-e", "tell application \"Notes\"\ntell account \"iCloud\"\ntell folder \"Notes\"\nmake new note with properties {name:\"buy saisai\", body:\"\"}\nend tell\nend tell\nend tell"]`
+   - On success, confirm: "Done — I added an Apple Note titled \"…\"."
+   - If osascript is not in ALLOWED_BINARIES or the command errors: give the user the note text and steps to run `memo notes -a -f "Notes"` in the terminal and paste the content when the editor opens.
+
+2. **List and search**
+   - **run_command** with `binary: "memo"`, `args: ["notes"]` for list; `args: ["notes", "-s", "query"]` for search.
+
+3. **Do not**
+   - Do not use run_command with memo `["notes", "-a", "title"]`; memo rejects extra arguments.
+   - Do not leave the user without a path to success: either add via osascript (run_command) or give text + steps for memo notes -a, or explain why (e.g. add osascript to ALLOWED_BINARIES).

package/registry/bluesky.md

@@ -0,0 +1,111 @@
+---
+name: bluesky
+description: Post to Bluesky (AT Protocol). Use when the user asks to post a tweet/thread to Bluesky, share content on Bluesky, or post news/headlines from a source (URL or text) to Bluesky.
+homepage: https://bsky.app
+metadata:
+  {
+    "sulala": {
+      "emoji": "🦋",
+      "requires": { "bins": ["curl", "python3", "sh"], "env": ["BSKY_HANDLE", "BSKY_APP_PASSWORD"] },
+      "primaryEnv": "BSKY_APP_PASSWORD"
+    }
+  }
+---
+
+# Bluesky Posting
+
+Post to Bluesky via the AT Protocol. Use **run_command** with `curl`, `python3`, and `sh`. Add `curl`, `python3`, and `sh` to ALLOWED_BINARIES.
+
+Requires `BSKY_HANDLE` (e.g. `your.bsky.social`) and `BSKY_APP_PASSWORD` (app password from bsky.app → Settings → App Passwords). Set them in `.env` or in the skill config (`~/.sulala/config.json` or `.sulala/config.json` in the project; see Skill config in the dashboard). Config is re-read when the file changes; enable/disable takes effect without restart.
+
+**IMPORTANT:** `run_command` does not run a shell — `$BSKY_HANDLE` and `$BSKY_APP_PASSWORD` will not expand if you call curl directly. Always use `binary: "sh"` and `args: ["-c", "curl ... $BSKY_HANDLE ... $BSKY_APP_PASSWORD ..."]` so the env vars expand.
+
+## When to Use
+
+- "Post this to Bluesky"
+- "Share [content] on Bluesky"
+- "Post news from [URL] to Bluesky"
+- "Post a headline about [topic]"
+
+## Post Flow (non-interactive)
+
+### 1. Ensure credentials
+
+```
+BSKY_HANDLE="${BSKY_HANDLE:?Set BSKY_HANDLE}"
+BSKY_APP_PASSWORD="${BSKY_APP_PASSWORD:?Set BSKY_APP_PASSWORD}"
+```
+
+If empty, read from Sulala config:
+
+```
+CONFIG_PATH="${SULALA_CONFIG_PATH:-$HOME/.sulala/config.json}"
+# If using workspace config, use: CONFIG_PATH=".sulala/config.json" (when run from project root)
+BSKY_HANDLE=$(cat "$CONFIG_PATH" 2>/dev/null | python3 -c "import sys,json; d=json.load(sys.stdin); e=d.get('skills',{}).get('entries',{}).get('bluesky',{}); print(e.get('handle','') or e.get('apiKey',''))" 2>/dev/null)
+BSKY_APP_PASSWORD=$(cat "$CONFIG_PATH" 2>/dev/null | python3 -c "import sys,json; d=json.load(sys.stdin); e=d.get('skills',{}).get('entries',{}).get('bluesky',{}); print(e.get('apiKey','') or e.get('password',''))" 2>/dev/null)
+```
+
+(Config may use `handle` + `apiKey` for Bluesky. Adjust field names if your config differs.)
+
+### 2. Create session (login)
+
+**Use `run_command` with `binary: "sh"` and `args: ["-c", "..."]`** so `$BSKY_HANDLE` and `$BSKY_APP_PASSWORD` expand from the environment. Do NOT call curl directly.
+
+```bash
+sh -c 'SESSION=$(curl -s -X POST "https://bsky.social/xrpc/com.atproto.server.createSession" -H "Content-Type: application/json" -d "{\"identifier\": \"$BSKY_HANDLE\", \"password\": \"$BSKY_APP_PASSWORD\"}"); echo "$SESSION"'
+```
+
+Then parse the JSON output with `python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('accessJwt',''), d.get('did',''))"` to get `ACCESS_TOKEN` and `DID`.
+
+If the session response contains `"error"` or `"AuthenticationRequired"`, report: "Bluesky login failed. Check BSKY_HANDLE and BSKY_APP_PASSWORD in .env."
+
+### 3. Create post
+
+Text must be JSON-escaped. Use python to build the payload. **Use `run_command` with `binary: "sh"`** so `$ACCESS_TOKEN`, `$DID`, and other vars expand.
+
+Run a single `sh -c` that chains steps 2 and 3 so SESSION, ACCESS_TOKEN, DID persist in the same shell:
+
+```bash
+sh -c '
+  SESSION=$(curl -s -X POST "https://bsky.social/xrpc/com.atproto.server.createSession" \
+    -H "Content-Type: application/json" \
+    -d "{\"identifier\": \"$BSKY_HANDLE\", \"password\": \"$BSKY_APP_PASSWORD\"}");
+  ACCESS_TOKEN=$(echo "$SESSION" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get(\"accessJwt\",\"\"))");
+  DID=$(echo "$SESSION" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get(\"did\",\"\"))");
+  if [ -z "$ACCESS_TOKEN" ]; then echo "Login failed"; exit 1; fi;
+  POST_TEXT="Your post content here";
+  POST_JSON=$(python3 -c "import sys,json; print(json.dumps(sys.argv[1]))" "$POST_TEXT");
+  NOW=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z");
+  curl -s -X POST "https://bsky.social/xrpc/com.atproto.repo.createRecord" \
+    -H "Authorization: Bearer $ACCESS_TOKEN" \
+    -H "Content-Type: application/json" \
+    -d "{\"repo\": \"$DID\", \"collection\": \"app.bsky.feed.post\", \"record\": {\"\\$type\": \"app.bsky.feed.post\", \"text\": $POST_JSON, \"createdAt\": \"$NOW\"}}"
+'
+```
+
+Replace `Your post content here` with the user's post text.
+
+If the response contains `"uri"`, the post succeeded. Otherwise report the error.
+
+## Posting from a news source
+
+When the user wants to post **news** or **content from a URL**:
+
+1. **Fetch the content** (e.g. with `curl -s <URL>` or read a file).
+2. **Summarize** if the content is long — Bluesky posts are max 300 characters. Write a short headline or summary.
+3. **Post** using the flow above. Optionally append the source URL if it fits within 300 chars.
+
+Example for "post news from https://example.com/article":
+- Fetch the page, extract title/lead.
+- Build post: "Headline here — https://example.com/article"
+- Post via the createRecord flow above.
+
+## Character limit
+
+Bluesky posts are limited to 300 characters. If the user's text or your summary exceeds that, truncate or split into multiple posts (thread). For a thread, create each post separately; the API does not natively support threads — you would need to reference the previous post's URI if linking them (advanced).
+
+## Notes
+
+- Use an **app password**, not the main account password. Create at bsky.app → Settings → App Passwords.
+- `bsky.social` is the default PDS; custom PDS users would need a different host.
+- Do not embed real credentials in the skill or in replies — use env or config.

package/registry/files.md

@@ -0,0 +1,30 @@
+---
+name: files
+description: Basic file operations via run_command. Use when the user asks to list files, show file contents, search within files, or inspect directories.
+metadata:
+  {
+    "sulala": {
+      "requires": { "bins": [] }
+    }
+  }
+---
+
+# File operations
+
+Use **run_command** with common shell tools to read and inspect files. Add required binaries to ALLOWED_BINARIES (e.g. ls, cat, head, tail, wc, grep, find).
+
+## List files
+
+- `ls` — list directory contents
+- `ls -la` — long format with hidden files
+
+## Read files
+
+- `cat path/to/file` — output entire file
+- `head -n 20 path/to/file` — first 20 lines
+- `tail -n 50 path/to/file` — last 50 lines
+
+## Search
+
+- `grep -r "pattern" path/` — search in files recursively
+- `find path -name "*.md"` — find files by name

package/registry/git.md

@@ -0,0 +1,37 @@
+---
+name: git
+description: Basic Git operations via run_command. Use when the user asks to check status, diff, log, branch, or perform simple git commands.
+metadata:
+  {
+    "sulala": {
+      "requires": { "bins": ["git"] }
+    }
+  }
+---
+
+# Git operations
+
+Use **run_command** with `binary: "git"` and appropriate args. Add `git` to ALLOWED_BINARIES.
+
+## Status and diff
+
+- `git status`
+- `git diff`
+- `git diff --staged`
+- `git log -n 10 --oneline`
+
+## Branches
+
+- `git branch`
+- `git branch -a`
+- `git checkout -b new-branch`
+
+## Info
+
+- `git show HEAD:path/to/file` — show file at HEAD
+- `git rev-parse --abbrev-ref HEAD` — current branch name
+
+## Limits
+
+- Do not run destructive commands (reset --hard, push --force) without explicit user confirmation.
+- Prefer read-only commands when the user only asks to inspect.