@symerian/symi 3.0.17 → 3.0.19

package/skills/safe-edit/SKILL.md

@@ -1,51 +0,0 @@
----
-name: safe-edit
-description: Best practices for the edit tool plus recovery patterns when oldText doesn't match. Read before editing, use shortest unique snippets, prefer distinctive lines, never skip past a failed match. Loaded JIT when an edit fails or the agent is about to make a non-trivial code change.
-triggers: [edit, oldtext, recovery, match, failed, wrong, snippet, hallucinated]
----
-
-# Safe Edit — best practices and recovery patterns
-
-The `edit` tool replaces an exact `oldText` snippet with `newText`. When `oldText` doesn't match, the call fails. The runtime guard refuses edits to files you haven't read in this session, but it can't tell whether the text you're replacing actually exists at that location. This skill is the discipline that prevents wasted turns.
-
-## Before any edit
-
-1. **Read the file first.** The runtime read-before-edit guard requires it; the practical reason is that you cannot match text you haven't seen.
-2. **Locate the exact text** in the read output. Copy-paste it directly — do not retype, do not "remember" it.
-3. **Choose the shortest unique snippet** that identifies the location. 1-3 lines is usually right. Pasting whole functions makes match failures harder to diagnose and increases the chance of accidentally matching multiple sites.
-4. **Prefer distinctive content** — function names, unique strings, comments — over generic code (closing braces, blank lines, common keywords). Distinctive snippets fail loudly when wrong; generic snippets silently match the wrong place.
-
-## When an edit fails
-
-If `edit` returns an error like "Could not find the exact text", do NOT:
-
-- Skip to a different file or task.
-- Paraphrase the oldText and retry.
-- Try with whitespace tweaks ("maybe it's tabs not spaces").
-
-Instead:
-
-1. **Re-read the file** with `read`. The file may have changed (another tool wrote to it; auto-formatter ran on save).
-2. **Copy the exact text from the fresh read output** into your retry. Whitespace, indentation, line endings — match precisely.
-3. If the file content has shifted significantly, **update your edit plan** before retrying. Don't bash on the same wrong text.
-
-## When the file content surprises you
-
-If the read output doesn't look like what you expected:
-
-- Check the path is right (relative vs absolute, workspace vs sandbox).
-- Confirm you're in the right session (workspace dir matches your assumption).
-- Look for a recent `write` that may have replaced the file content wholesale.
-
-## Multi-edit workflow
-
-If you need several edits to the same file:
-
-- Make them one at a time, re-reading between non-adjacent edits.
-- For tightly-coupled edits (e.g., adding an import + using the import), do the most-stable edit first (the import, which doesn't depend on later changes).
-- After each successful edit, the file's content has changed — older snippets you saved from an earlier read may no longer match.
-
-## What this skill is not
-
-- **Not a refactoring strategy.** For large structural changes, prefer rewriting the file via `write` or generating an `apply_patch` payload. The edit tool is for surgical replacements, not whole-section rewrites.
-- **Not a substitute for reading.** Even with this skill loaded, you still must `read` first.

package/skills/sag/SKILL.md

@@ -1,88 +0,0 @@
----
-name: sag
-description: ElevenLabs text-to-speech with mac-style say UX.
-homepage: https://sag.sh
-metadata:
-  {
-    "symi":
-      {
-        "emoji": "🗣️",
-        "requires": { "bins": ["sag"], "env": ["ELEVENLABS_API_KEY"] },
-        "primaryEnv": "ELEVENLABS_API_KEY",
-        "install":
-          [
-            {
-              "id": "brew",
-              "kind": "brew",
-              "formula": "steipete/tap/sag",
-              "bins": ["sag"],
-              "label": "Install sag (brew)",
-            },
-          ],
-      },
-  }
-triggers: [sag]
----
-
-# sag
-
-Use `sag` for ElevenLabs TTS with local playback.
-
-API key (required)
-
-- `ELEVENLABS_API_KEY` (preferred)
-- `SAG_API_KEY` also supported by the CLI
-
-Quick start
-
-- `sag "Hello there"`
-- `sag speak -v "Roger" "Hello"`
-- `sag voices`
-- `sag prompting` (model-specific tips)
-
-Model notes
-
-- Default: `eleven_v3` (expressive)
-- Stable: `eleven_multilingual_v2`
-- Fast: `eleven_flash_v2_5`
-
-Pronunciation + delivery rules
-
-- First fix: respell (e.g. "key-note"), add hyphens, adjust casing.
-- Numbers/units/URLs: `--normalize auto` (or `off` if it harms names).
-- Language bias: `--lang en|de|fr|...` to guide normalization.
-- v3: SSML `<break>` not supported; use `[pause]`, `[short pause]`, `[long pause]`.
-- v2/v2.5: SSML `<break time="1.5s" />` supported; `<phoneme>` not exposed in `sag`.
-
-v3 audio tags (put at the entrance of a line)
-
-- `[whispers]`, `[shouts]`, `[sings]`
-- `[laughs]`, `[starts laughing]`, `[sighs]`, `[exhales]`
-- `[sarcastic]`, `[curious]`, `[excited]`, `[crying]`, `[mischievously]`
-- Example: `sag "[whispers] keep this quiet. [short pause] ok?"`
-
-Voice defaults
-
-- `ELEVENLABS_VOICE_ID` or `SAG_VOICE_ID`
-
-Confirm voice + speaker before long output.
-
-## Chat voice responses
-
-When Peter asks for a "voice" reply (e.g., "crazy scientist voice", "explain in voice"), generate audio and send it:
-
-```bash
-# Generate audio file
-sag -v Symi -o /tmp/voice-reply.mp3 "Your message here"
-
-# Then include in reply:
-# MEDIA:/tmp/voice-reply.mp3
-```
-
-Voice character tips:
-
-- Crazy scientist: Use `[excited]` tags, dramatic pauses `[short pause]`, vary intensity
-- Calm: Use `[whispers]` or slower pacing
-- Dramatic: Use `[sings]` or `[shouts]` sparingly
-
-Default voice for Symi: `lj2rcrvANS3gaWWnczSX` (or just `-v Symi`)

package/skills/sherpa-onnx-tts/SKILL.md

@@ -1,104 +0,0 @@
----
-name: sherpa-onnx-tts
-description: Local text-to-speech via sherpa-onnx (offline, no cloud)
-metadata:
-  {
-    "symi":
-      {
-        "emoji": "🗣️",
-        "os": ["darwin", "linux", "win32"],
-        "requires": { "env": ["SHERPA_ONNX_RUNTIME_DIR", "SHERPA_ONNX_MODEL_DIR"] },
-        "install":
-          [
-            {
-              "id": "download-runtime-macos",
-              "kind": "download",
-              "os": ["darwin"],
-              "url": "https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-osx-universal2-shared.tar.bz2",
-              "archive": "tar.bz2",
-              "extract": true,
-              "stripComponents": 1,
-              "targetDir": "runtime",
-              "label": "Download sherpa-onnx runtime (macOS)",
-            },
-            {
-              "id": "download-runtime-linux-x64",
-              "kind": "download",
-              "os": ["linux"],
-              "url": "https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-linux-x64-shared.tar.bz2",
-              "archive": "tar.bz2",
-              "extract": true,
-              "stripComponents": 1,
-              "targetDir": "runtime",
-              "label": "Download sherpa-onnx runtime (Linux x64)",
-            },
-            {
-              "id": "download-runtime-win-x64",
-              "kind": "download",
-              "os": ["win32"],
-              "url": "https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-win-x64-shared.tar.bz2",
-              "archive": "tar.bz2",
-              "extract": true,
-              "stripComponents": 1,
-              "targetDir": "runtime",
-              "label": "Download sherpa-onnx runtime (Windows x64)",
-            },
-            {
-              "id": "download-model-lessac",
-              "kind": "download",
-              "url": "https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/vits-piper-en_US-lessac-high.tar.bz2",
-              "archive": "tar.bz2",
-              "extract": true,
-              "targetDir": "models",
-              "label": "Download Piper en_US lessac (high)",
-            },
-          ],
-      },
-  }
-triggers: [sherpa-onnx-tts, sherpa, onnx, tts]
----
-
-# sherpa-onnx-tts
-
-Local TTS using the sherpa-onnx offline CLI.
-
-## Install
-
-1. Download the runtime for your OS (extracts into `~/.symi/tools/sherpa-onnx-tts/runtime`)
-2. Download a voice model (extracts into `~/.symi/tools/sherpa-onnx-tts/models`)
-
-Update `~/.symi/symi.json`:
-
-```json5
-{
-  skills: {
-    entries: {
-      "sherpa-onnx-tts": {
-        env: {
-          SHERPA_ONNX_RUNTIME_DIR: "~/.symi/tools/sherpa-onnx-tts/runtime",
-          SHERPA_ONNX_MODEL_DIR: "~/.symi/tools/sherpa-onnx-tts/models/vits-piper-en_US-lessac-high",
-        },
-      },
-    },
-  },
-}
-```
-
-The wrapper lives in this skill folder. Run it directly, or add the wrapper to PATH:
-
-```bash
-export PATH="{baseDir}/bin:$PATH"
-```
-
-## Usage
-
-```bash
-{baseDir}/bin/sherpa-onnx-tts -o ./tts.wav "Hello from local TTS."
-```
-
-Notes:
-
-- Pick a different model from the sherpa-onnx `tts-models` release if you want another voice.
-- If the model dir has multiple `.onnx` files, set `SHERPA_ONNX_MODEL_FILE` or pass `--model-file`.
-- You can also pass `--tokens-file` or `--data-dir` to override the defaults.
-- Windows: run `node {baseDir}\\bin\\sherpa-onnx-tts -o tts.wav "Hello from local TTS."`

package/skills/sherpa-onnx-tts/bin/sherpa-onnx-tts

@@ -1,178 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require("node:fs");
-const path = require("node:path");
-const { spawnSync } = require("node:child_process");
-
-function usage(message) {
-  if (message) {
-    console.error(message);
-  }
-  console.error(
-    "\nUsage: sherpa-onnx-tts [--runtime-dir <dir>] [--model-dir <dir>] [--model-file <file>] [--tokens-file <file>] [--data-dir <dir>] [--output <file>] \"text\"",
-  );
-  console.error("\nRequired env (or flags):\n  SHERPA_ONNX_RUNTIME_DIR\n  SHERPA_ONNX_MODEL_DIR");
-  process.exit(1);
-}
-
-function resolveRuntimeDir(explicit) {
-  const value = explicit || process.env.SHERPA_ONNX_RUNTIME_DIR || "";
-  return value.trim();
-}
-
-function resolveModelDir(explicit) {
-  const value = explicit || process.env.SHERPA_ONNX_MODEL_DIR || "";
-  return value.trim();
-}
-
-function resolveModelFile(modelDir, explicitFlag) {
-  const explicit = (explicitFlag || process.env.SHERPA_ONNX_MODEL_FILE || "").trim();
-  if (explicit) return explicit;
-  try {
-    const candidates = fs
-      .readdirSync(modelDir)
-      .filter((entry) => entry.endsWith(".onnx"))
-      .map((entry) => path.join(modelDir, entry));
-    if (candidates.length === 1) return candidates[0];
-  } catch {
-    return "";
-  }
-  return "";
-}
-
-function resolveTokensFile(modelDir, explicitFlag) {
-  const explicit = (explicitFlag || process.env.SHERPA_ONNX_TOKENS_FILE || "").trim();
-  if (explicit) return explicit;
-  const candidate = path.join(modelDir, "tokens.txt");
-  return fs.existsSync(candidate) ? candidate : "";
-}
-
-function resolveDataDir(modelDir, explicitFlag) {
-  const explicit = (explicitFlag || process.env.SHERPA_ONNX_DATA_DIR || "").trim();
-  if (explicit) return explicit;
-  const candidate = path.join(modelDir, "espeak-ng-data");
-  return fs.existsSync(candidate) ? candidate : "";
-}
-
-function resolveBinary(runtimeDir) {
-  const binName = process.platform === "win32" ? "sherpa-onnx-offline-tts.exe" : "sherpa-onnx-offline-tts";
-  return path.join(runtimeDir, "bin", binName);
-}
-
-function prependEnvPath(current, next) {
-  if (!next) return current;
-  if (!current) return next;
-  return `${next}${path.delimiter}${current}`;
-}
-
-const args = process.argv.slice(2);
-let runtimeDir = "";
-let modelDir = "";
-let modelFile = "";
-let tokensFile = "";
-let dataDir = "";
-let output = "tts.wav";
-const textParts = [];
-
-for (let i = 0; i < args.length; i += 1) {
-  const arg = args[i];
-  if (arg === "--runtime-dir") {
-    runtimeDir = args[i + 1] || "";
-    i += 1;
-    continue;
-  }
-  if (arg === "--model-dir") {
-    modelDir = args[i + 1] || "";
-    i += 1;
-    continue;
-  }
-  if (arg === "--model-file") {
-    modelFile = args[i + 1] || "";
-    i += 1;
-    continue;
-  }
-  if (arg === "--tokens-file") {
-    tokensFile = args[i + 1] || "";
-    i += 1;
-    continue;
-  }
-  if (arg === "--data-dir") {
-    dataDir = args[i + 1] || "";
-    i += 1;
-    continue;
-  }
-  if (arg === "-o" || arg === "--output") {
-    output = args[i + 1] || output;
-    i += 1;
-    continue;
-  }
-  if (arg === "--text") {
-    textParts.push(args[i + 1] || "");
-    i += 1;
-    continue;
-  }
-  textParts.push(arg);
-}
-
-runtimeDir = resolveRuntimeDir(runtimeDir);
-modelDir = resolveModelDir(modelDir);
-
-if (!runtimeDir || !modelDir) {
-  usage("Missing runtime/model directory.");
-}
-
-modelFile = resolveModelFile(modelDir, modelFile);
-tokensFile = resolveTokensFile(modelDir, tokensFile);
-dataDir = resolveDataDir(modelDir, dataDir);
-
-if (!modelFile || !tokensFile || !dataDir) {
-  usage(
-    "Model directory is missing required files. Set SHERPA_ONNX_MODEL_FILE, SHERPA_ONNX_TOKENS_FILE, SHERPA_ONNX_DATA_DIR or pass --model-file/--tokens-file/--data-dir.",
-  );
-}
-
-const text = textParts.join(" ").trim();
-if (!text) {
-  usage("Missing text.");
-}
-
-const bin = resolveBinary(runtimeDir);
-if (!fs.existsSync(bin)) {
-  usage(`TTS binary not found: ${bin}`);
-}
-
-const env = { ...process.env };
-const libDir = path.join(runtimeDir, "lib");
-if (process.platform === "darwin") {
-  env.DYLD_LIBRARY_PATH = prependEnvPath(env.DYLD_LIBRARY_PATH || "", libDir);
-} else if (process.platform === "win32") {
-  env.PATH = prependEnvPath(env.PATH || "", [path.join(runtimeDir, "bin"), libDir].join(path.delimiter));
-} else {
-  env.LD_LIBRARY_PATH = prependEnvPath(env.LD_LIBRARY_PATH || "", libDir);
-}
-
-const outputPath = path.isAbsolute(output) ? output : path.join(process.cwd(), output);
-fs.mkdirSync(path.dirname(outputPath), { recursive: true });
-
-const child = spawnSync(
-  bin,
-  [
-    `--vits-model=${modelFile}`,
-    `--vits-tokens=${tokensFile}`,
-    `--vits-data-dir=${dataDir}`,
-    `--output-filename=${outputPath}`,
-    text,
-  ],
-  {
-    stdio: "inherit",
-    env,
-  },
-);
-
-if (typeof child.status === "number") {
-  process.exit(child.status);
-}
-if (child.error) {
-  console.error(child.error.message || String(child.error));
-}
-process.exit(1);

package/skills/songsee/SKILL.md

@@ -1,50 +0,0 @@
----
-name: songsee
-description: Generate spectrograms and feature-panel visualizations from audio with the songsee CLI.
-homepage: https://github.com/steipete/songsee
-metadata:
-  {
-    "symi":
-      {
-        "emoji": "🌊",
-        "requires": { "bins": ["songsee"] },
-        "install":
-          [
-            {
-              "id": "brew",
-              "kind": "brew",
-              "formula": "steipete/tap/songsee",
-              "bins": ["songsee"],
-              "label": "Install songsee (brew)",
-            },
-          ],
-      },
-  }
-triggers: [songsee]
----
-
-# songsee
-
-Generate spectrograms + feature panels from audio.
-
-Quick start
-
-- Spectrogram: `songsee track.mp3`
-- Multi-panel: `songsee track.mp3 --viz spectrogram,mel,chroma,hpss,selfsim,loudness,tempogram,mfcc,flux`
-- Time slice: `songsee track.mp3 --start 12.5 --duration 8 -o slice.jpg`
-- Stdin: `cat track.mp3 | songsee - --format png -o out.png`
-
-Common flags
-
-- `--viz` list (repeatable or comma-separated)
-- `--style` palette (classic, magma, inferno, viridis, gray)
-- `--width` / `--height` output size
-- `--window` / `--hop` FFT settings
-- `--min-freq` / `--max-freq` frequency range
-- `--start` / `--duration` time slice
-- `--format` jpg|png
-
-Notes
-
-- WAV/MP3 decode native; other formats use ffmpeg if available.
-- Multiple `--viz` renders a grid.

package/skills/sonoscli/SKILL.md

@@ -1,66 +0,0 @@
----
-name: sonoscli
-description: Control Sonos speakers (discover/status/play/volume/group).
-homepage: https://sonoscli.sh
-metadata:
-  {
-    "symi":
-      {
-        "emoji": "🔊",
-        "requires": { "bins": ["sonos"] },
-        "install":
-          [
-            {
-              "id": "go",
-              "kind": "go",
-              "module": "github.com/steipete/sonoscli/cmd/sonos@latest",
-              "bins": ["sonos"],
-              "label": "Install sonoscli (go)",
-            },
-          ],
-      },
-  }
-triggers: [sonoscli]
----
-
-# Sonos CLI
-
-Use `sonos` to control Sonos speakers on the local network.
-
-## Quick start
-
-- `sonos discover`
-- `sonos status --name "Kitchen"`
-- `sonos play|pause|stop --name "Kitchen"`
-- `sonos volume set 15 --name "Kitchen"`
-
-## Common tasks
-
-- Grouping: `sonos group status|join|unjoin|party|solo`
-- Favorites: `sonos favorites list|open`
-- Queue: `sonos queue list|play|clear`
-- Spotify search (via SMAPI): `sonos smapi search --service "Spotify" --category tracks "query"`
-
-## Notes
-
-- If SSDP fails, specify `--ip <speaker-ip>`.
-- Spotify Web API search is optional and requires `SPOTIFY_CLIENT_ID/SECRET`.
-- If there is an error, check the troubleshooting section and offer advice if there is a decent match.
-
-## Troubleshooting
-
-### `sonos discover` - `no route to host`
-
-- On error `Error: write udp4 0.0.0.0:64326->239.255.255.250:1900: sendto: no route to host (Command exited with code 1)`
-  - Note that the port number after `0.0.0.0:` is ephemeral and will change and the netmask may not match exactly either
-  - The `sendto: no route to host` should stay consistent
-- Advise the user that in `direct` (no Docker sandbox) mode on Mac OS that Settings -> Privacy & Security -> Local Network will need to be enabled for the top-level host parent process of the Gateway
-  - `node` if running via `launchd`
-  - `Terminal` if running the gateway directly in the terminal
-  - `Visual Studio Code` if running via terminal in VS Code
-- An alternative option is to use `sandbox` (docker container) with network access allowed for that sandbox
-
-### `sonos discover` - `bind: operation not permitted`
-
-- On error `Error: listen udp4 0.0.0.0:0: bind: operation not permitted`
-- Advise the user that they may be running via a Codex or other sandbox that does not permit network access (this can be replicated by running `sonos discover` within a Codex CLI session with sandbox enabled and not approving the escalation request)

package/skills/spotify-player/SKILL.md

@@ -1,65 +0,0 @@
----
-name: spotify-player
-description: Terminal Spotify playback/search via spogo (preferred) or spotify_player.
-homepage: https://www.spotify.com
-metadata:
-  {
-    "symi":
-      {
-        "emoji": "🎵",
-        "requires": { "anyBins": ["spogo", "spotify_player"] },
-        "install":
-          [
-            {
-              "id": "brew",
-              "kind": "brew",
-              "formula": "spogo",
-              "tap": "steipete/tap",
-              "bins": ["spogo"],
-              "label": "Install spogo (brew)",
-            },
-            {
-              "id": "brew",
-              "kind": "brew",
-              "formula": "spotify_player",
-              "bins": ["spotify_player"],
-              "label": "Install spotify_player (brew)",
-            },
-          ],
-      },
-  }
-triggers: [spotify-player, spotify, player]
----
-
-# spogo / spotify_player
-
-Use `spogo` **(preferred)** for Spotify playback/search. Fall back to `spotify_player` if needed.
-
-Requirements
-
-- Spotify Premium account.
-- Either `spogo` or `spotify_player` installed.
-
-spogo setup
-
-- Import cookies: `spogo auth import --browser chrome`
-
-Common CLI commands
-
-- Search: `spogo search track "query"`
-- Playback: `spogo play|pause|next|prev`
-- Devices: `spogo device list`, `spogo device set "<name|id>"`
-- Status: `spogo status`
-
-spotify_player commands (fallback)
-
-- Search: `spotify_player search "query"`
-- Playback: `spotify_player playback play|pause|next|previous`
-- Connect device: `spotify_player connect`
-- Like track: `spotify_player like`
-
-Notes
-
-- Config folder: `~/.config/spotify-player` (e.g., `app.toml`).
-- For Spotify Connect integration, set a user `client_id` in config.
-- TUI shortcuts are available via `?` in the app.

package/skills/symihub/SKILL.md

@@ -1,78 +0,0 @@
----
-name: symihub
-description: Use the SymiHub CLI to search, install, update, and publish agent skills from symihub.com. Use when you need to fetch new skills on the fly, sync installed skills to latest or a specific version, or publish new/updated skill folders with the npm-installed symihub CLI.
-metadata:
-  {
-    "symi":
-      {
-        "requires": { "bins": ["symihub"] },
-        "install":
-          [
-            {
-              "id": "node",
-              "kind": "node",
-              "package": "symihub",
-              "bins": ["symihub"],
-              "label": "Install SymiHub CLI (npm)",
-            },
-          ],
-      },
-  }
-triggers: [symihub]
----
-
-# SymiHub CLI
-
-Install
-
-```bash
-npm i -g symihub
-```
-
-Auth (publish)
-
-```bash
-symihub login
-symihub whoami
-```
-
-Search
-
-```bash
-symihub search "postgres backups"
-```
-
-Install
-
-```bash
-symihub install my-skill
-symihub install my-skill --version 1.2.3
-```
-
-Update (hash-based match + upgrade)
-
-```bash
-symihub update my-skill
-symihub update my-skill --version 1.2.3
-symihub update --all
-symihub update my-skill --force
-symihub update --all --no-input --force
-```
-
-List
-
-```bash
-symihub list
-```
-
-Publish
-
-```bash
-symihub publish ./my-skill --slug my-skill --name "My Skill" --version 1.2.0 --changelog "Fixes + docs"
-```
-
-Notes
-
-- Default registry: https://symihub.com (override with SYMIHUB_REGISTRY or --registry)
-- Default workdir: cwd (falls back to Symi workspace); install dir: ./skills (override with --workdir / --dir / SYMIHUB_WORKDIR)
-- Update command hashes local files, resolves matching version, and upgrades to latest unless --version is set