omnish 1.6.5 → 2.0.0

package/CHANGELOG.md

@@ -7,24 +7,100 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.0.0] - 2026-06-18
+
+### Breaking
+
+- **Platform routing:** unprefixed chat commands route to the **default device only**; use `>label cmd` for other hosts. Dashboard peer bindings no longer affect inbound dispatch ([docs/adr/0013-platform-device-prefix-routing.md](docs/adr/0013-platform-device-prefix-routing.md)).
+- **Cluster CLI:** `omnish cluster here` removed — use chat `/c here` or `omnish cluster use <sender> <label>`.
+- **Cluster chat:** `/c step-down` removed; per-sender binding via `/c unuse`.
+- **`clusterRole`:** informational only; no longer gates traffic.
+- **Telemetry default-on:** gateways send anonymous heartbeats unless `OMNISH_TELEMETRY=0` or `telemetryEnabled: false` ([docs/adr/0017-default-on-instance-telemetry.md](docs/adr/0017-default-on-instance-telemetry.md)).
+
 ### Added
 
+- **Connectors:** Signal integration; OAuth link flows for Slack, Discord, and Twitch; Slack DM gateway assets.
+- **Platform:** user auth (signup/login, email verification, password reset, SMTP templates); default device management; `/devices` routing commands; admin telemetry APIs and AdminView improvements.
+- **Integrations:** Omnish Cursor and Claude Code install/notify paths; enhanced `omnish-notify` config.
+- **Gateway:** lifecycle broadcast to allowlisted peers on startup/shutdown (with WhatsApp JID fix).
+- **Cluster:** WebSocket keep-alive; attached auto-binding on inbound; enhanced cluster state handling.
+- **CLI/UI:** `/apps start` flags; platform dashboard mobile nav; analytics hooks; `.nvmrc`.
+
+### Changed
+
+- Connector management and user allowlist handling.
+- Dependencies for expanded channel support.
+- Postinstall / native module checks.
+
+### Fixed
+
+- Signal QR display issue.
+- AdminView fetch error handling.
+
+[2.0.0]: https://github.com/labKnowledge/omnish/compare/v1.6.6...v2.0.0
+
+## [1.6.6] - 2026-05-30
+
+### Fixed
+
+- **macOS npm installs:** auto-fix `node-pty` `spawn-helper` execute permission at install (`postinstall`) and before the first PTY spawn so `!commands` and interactive sessions work after `npm install -g omnish`.
+
+### Changed
+
+- Pre-declare npm `allowScripts` for native dependencies (`node-pty`, `better-sqlite3`, Baileys/sharp/protobufjs, `@parcel/watcher`) to reduce npm 11+ install warnings.
+
+[1.6.6]: https://github.com/labKnowledge/omnish/compare/v1.6.5...v1.6.6
+
+## [1.6.5] - 2026-05-30
+
+### Added
+
+- **Chat agent daemon:** optional background agent with `chatAgentEnabled`, wrapper script, and `agent-notify` env wiring. See [docs/features/chat-agent-daemon.md](docs/features/chat-agent-daemon.md).
+- **Job board coordinator (default on):** clearer status handoffs, end-of-tick supervisor review, primary agent via `/board agent`, richer list/tick feedback, live-status and file delivery via `omnish i -c sendto`, and competency docs.
 - **Dev tooling:** Prettier with root [`.prettierrc.json`](.prettierrc.json); run `pnpm format` or `pnpm format:check` before submitting PRs (CI enforces format check).
 
 ### Changed
 
 - **Documentation search (chat):** `/docs search` → **`/s q`** (shorthand **`/s`**, full form **`/search`**). List, show, and follow moved to `/s` / `/search`. Legacy **`/docs`**, **`/help search`**, and **`omnish docs`** still work. Host CLI: **`omnish search q`**.
+- **`omnish start`:** start the gateway in the background by default (pairs with **`omnish stop`**). Foreground: **`omnish start -f`**. **`omnish run`** stays foreground unless **`-d`** is passed.
+- **Board notifications:** easier coordinator/employee notify paths via board communication helpers.
+
+### Fixed
+
+- **Board:** notification and competency wiring for coordinator workforce flows.
+
+[1.6.5]: https://github.com/labKnowledge/omnish/compare/v1.6.4...v1.6.5
+
+## [1.6.4] - 2026-05-24
 
 ### Added
 
-- **`omnish start`:** start the gateway in the background by default (pairs with **`omnish stop`**). Foreground: **`omnish start -f`**. **`omnish run`** stays foreground unless **`-d`** is passed.
+- **Digital employees / job board:** `/board` chat commands, employee harness, coordinator agent, competencies, example employee pack under `contrib/employee-pack-example/`, and guides ([docs/guides/digital-employees.md](docs/guides/digital-employees.md), [docs/features/job-board.md](docs/features/job-board.md)).
+- **Shortcuts with input:** slash shortcuts can prompt for missing arguments interactively.
+- **Whisper / transcribe:** transformers-backed transcribe path, config keys, and improved `/tr` / pull transcribe tooling.
 
-## [1.6.2] - 2026-05-23
+### Fixed
+
+- **Media `/edit` and transcribe:** parsing, tests, and reliability fixes for edit and transcription flows.
+
+[1.6.4]: https://github.com/labKnowledge/omnish/compare/v1.6.3...v1.6.4
+
+## [1.6.3] - 2026-05-23
 
 ### Security
 
 - **Baileys:** upgrade `@whiskeysockets/baileys` from `7.0.0-rc.9` to `7.0.0-rc13` (patches CVE-2026-48063 — message spoofing / app-state corruption).
 
+First **1.6.x** release on [npm](https://www.npmjs.com/package/omnish); registry skipped `1.6.0`–`1.6.2` (those versions exist only in this changelog / git history).
+
+[1.6.3]: https://github.com/labKnowledge/omnish/compare/v1.6.1...v1.6.3
+
+## [1.6.2] - 2026-05-23
+
+### Security
+
+- **Baileys:** same upgrade as [1.6.3] (CVE-2026-48063). Shipped to npm as **1.6.3** only.
+
 [1.6.2]: https://github.com/labKnowledge/omnish/compare/v1.6.1...v1.6.2
 
 ## [1.6.1] - 2026-05-23

package/README.md

@@ -79,6 +79,12 @@ Full steps for systemd, launchd, and Task Scheduler — **[docs/guides/backgroun
 
 Run `omnish status` to see the resolved data directory and auth path.
 
+## Telemetry (default-on, opt-out)
+
+While **`omnish run`** is active, omnish sends anonymous instance health metadata to the platform telemetry endpoint (default: `https://tunnel.omnish.dev`): install id (`~/.omnish/node-id`), omnish version, OS/arch, Node version, gateway mode, and enabled channel count. No message content, allowlists, or file paths are included.
+
+**Opt out:** `OMNISH_TELEMETRY=0` or `omnish config set telemetryEnabled false`. Override the endpoint with `telemetryUrl` in config.
+
 While **`omnish run`** is active, a localhost control channel may write **`gateway-control.json`** (and a random high port on `127.0.0.1`) so **`omnish i`** can request outbound file sends.
 
 Per-chat shell cwd is in `sessions.json`; **user shortcuts** are stored in `shortcuts.json` (same data directory).
@@ -112,6 +118,10 @@ omnish run
 
 **Single phone:** omnish runs on a PC or server; you link it like WhatsApp Web (one QR scan on your phone). See [Quick start — One phone with WhatsApp](docs/guides/quick-start.md#one-phone-with-whatsapp).
 
+**npm 11+ install warnings:** You may see advisory `allow-scripts` notices for native dependencies (`node-pty`, `better-sqlite3`, etc.). Install still succeeds; omnish pre-declares these in `allowScripts`. The `prebuild-install` deprecation warning comes from upstream native modules and is harmless.
+
+**macOS:** `node-pty` ships `spawn-helper` without the execute bit in its npm tarball ([upstream issue](https://github.com/microsoft/node-pty/issues/850)). omnish fixes this at install (`postinstall`) and before the first shell command. If `!commands` fail with `posix_spawnp failed` on an older install, update omnish or run `chmod +x "$(npm root -g)/omnish/node_modules/node-pty/prebuilds/darwin-"*"/spawn-helper"`.
+
 Native modules (for example **`node-pty`**) may compile on install. If postinstall scripts were skipped, enable them for this package and reinstall.
 
 ## Quick setup (from source)
@@ -153,24 +163,24 @@ Output is **debounced** (`appsFlushMs`, default 300 ms), **throttled** (`appsMin
 
 ### `/apps` cheat sheet
 
-| Command                                     | Action                                                                        |
-| ------------------------------------------- | ----------------------------------------------------------------------------- |
-| `/apps start <name> <cmd…>`                 | Spawn app session in session cwd; **auto-attaches** `<name>`.                 |
-| `/apps attach <name>`                       | Focus plain DMs on that running session.                                      |
-| `/apps detach`                              | Clear focus.                                                                  |
-| `/apps list`                                | Sessions for this chat; `*` marks focus. Shows `attached: …` or `(no focus)`. |
-| `/apps info <name>` / `/apps get <name>`    | Cmd, cwd, env key count, terminal size, ring bytes, log path/size, mute/raw.  |
-| `/apps send <name> <text>`                  | Write `text` + newline (no attach).                                           |
-| `>name text`                                | Same as `/apps send`.                                                         |
-| `/apps key <name> KEY[,KEY…]`               | Special keys: `Enter`, `Tab`, `Esc`, arrows, `^C`, `ctrl+d`, `\x1b`, …        |
-| `/apps tail <name> [lines]`                 | Last _lines_ of log (default `appsLogTailLines`).                             |
-| `/apps since <name>`                        | New log bytes since your last `/apps since` for that name.                    |
-| `/apps mute <name>` / `/apps unmute <name>` | Pause / resume streaming to the chat (log still grows).                       |
-| `/apps raw <name> on\|off`                  | Keep ANSI in streamed messages when `on`.                                     |
-| `/apps resize <name> <cols> <rows>`         | Resize terminal.                                                              |
-| `/apps stop <name>`                         | SIGTERM; SIGKILL after 5 s if still alive.                                    |
-| `/apps kill <name>`                         | SIGKILL immediately.                                                          |
-| `/apps rm <name>`                           | Only after the process has **exited**; removes metadata + log file.           |
+| Command                                                   | Action                                                                                    |
+| --------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| `/apps start <name> [--mute\|-mute\|--detach\|-d] <cmd…>` | Spawn in session cwd; **auto-attaches** unless `--detach`; `--mute` skips chat streaming. |
+| `/apps attach <name>`                                     | Focus plain DMs on that running session.                                                  |
+| `/apps detach`                                            | Clear focus.                                                                              |
+| `/apps list`                                              | Sessions for this chat; `*` marks focus. Shows `attached: …` or `(no focus)`.             |
+| `/apps info <name>` / `/apps get <name>`                  | Cmd, cwd, env key count, terminal size, ring bytes, log path/size, mute/raw.              |
+| `/apps send <name> <text>`                                | Write `text` + newline (no attach).                                                       |
+| `>name text`                                              | Same as `/apps send`.                                                                     |
+| `/apps key <name> KEY[,KEY…]`                             | Special keys: `Enter`, `Tab`, `Esc`, arrows, `^C`, `ctrl+d`, `\x1b`, …                    |
+| `/apps tail <name> [lines]`                               | Last _lines_ of log (default `appsLogTailLines`).                                         |
+| `/apps since <name>`                                      | New log bytes since your last `/apps since` for that name.                                |
+| `/apps mute <name>` / `/apps unmute <name>`               | Pause / resume streaming to the chat (log still grows).                                   |
+| `/apps raw <name> on\|off`                                | Keep ANSI in streamed messages when `on`.                                                 |
+| `/apps resize <name> <cols> <rows>`                       | Resize terminal.                                                                          |
+| `/apps stop <name>`                                       | SIGTERM; SIGKILL after 5 s if still alive.                                                |
+| `/apps kill <name>`                                       | SIGKILL immediately.                                                                      |
+| `/apps rm <name>`                                         | Only after the process has **exited**; removes metadata + log file.                       |
 
 To send a literal `!`, `/`, or `>` to the attached program, use **`/apps send <name> …`** or **`>name …`**.
 
@@ -262,6 +272,8 @@ Index and curated paths: **[docs/README.md](docs/README.md)**.
 | Documentation search (`/s`, `omnish search`)                   | [docs/features/docs-search-from-chat.md](docs/features/docs-search-from-chat.md)       |
 | System agents + `/run`                                         | [docs/guides/system-agents-and-run.md](docs/guides/system-agents-and-run.md)           |
 | MCP IDE spike (experimental)                                   | [contrib/mcp-spike/README.md](contrib/mcp-spike/README.md)                             |
+| Cursor integration (hooks + skill)                             | [contrib/omnish-cursor/README.md](contrib/omnish-cursor/README.md)                     |
+| Claude Code integration (hooks + skill)                        | [contrib/omnish-claude/README.md](contrib/omnish-claude/README.md)                     |
 | Telegram                                                       | [docs/telegram-integration-notes.md](docs/telegram-integration-notes.md)               |
 | Send/receive files (`/send` selectors, `/sendto` destinations) | [docs/files-send-receive.md](docs/files-send-receive.md)                               |
 | Troubleshooting                                                | [docs/advanced/troubleshooting.md](docs/advanced/troubleshooting.md)                   |

package/config.example.json

@@ -38,6 +38,7 @@
   "clusterRole": "secondary",
   "clusterSenderBindings": {},
   "serviceInstallFromChat": false,
+  "agentInstallFromChat": false,
   "updateCheckEnabled": false,
   "updateCheckIntervalMs": 86400000,
   "updateCheckPackageName": "omnish",

package/dist/downloads/omnish-claude/install.sh

@@ -0,0 +1,174 @@
+#!/usr/bin/env bash
+# Install Omnish Claude Code bundle: Stop hook + skill into ~/.claude
+set -euo pipefail
+
+OMNISH_CLAUDE_BUNDLE_URL="${OMNISH_CLAUDE_BUNDLE_URL:-https://omnish.dev/downloads/omnish-claude.tar.gz}"
+_TMP_BUNDLE_DIR=""
+
+need() {
+  command -v "$1" >/dev/null 2>&1 || {
+    echo "error: required command not found: $1" >&2
+    exit 1
+  }
+}
+
+cleanup() {
+  if [[ -n "$_TMP_BUNDLE_DIR" && -d "$_TMP_BUNDLE_DIR" ]]; then
+    rm -rf "$_TMP_BUNDLE_DIR"
+  fi
+}
+
+_SCRIPT="${BASH_SOURCE[0]:-}"
+if [[ -n "$_SCRIPT" && -f "$_SCRIPT" ]]; then
+  ROOT="$(cd "$(dirname "$_SCRIPT")" && pwd)"
+else
+  need curl
+  need tar
+  _TMP_BUNDLE_DIR="$(mktemp -d "${TMPDIR:-/tmp}/omnish-claude.XXXXXX")"
+  trap cleanup EXIT
+  echo "Downloading Omnish Claude Code bundle..." >&2
+  curl -fsSL "$OMNISH_CLAUDE_BUNDLE_URL" | tar -xzf - -C "$_TMP_BUNDLE_DIR"
+  if [[ ! -d "$_TMP_BUNDLE_DIR/omnish-claude" ]]; then
+    echo "error: bundle missing omnish-claude/ top-level directory" >&2
+    exit 1
+  fi
+  ROOT="$_TMP_BUNDLE_DIR/omnish-claude"
+fi
+
+CLAUDE_DIR="${CLAUDE_DIR:-$HOME/.claude}"
+HOOKS_DIR="$CLAUDE_DIR/hooks"
+SKILL_DIR="$CLAUDE_DIR/skills/omnish"
+SETTINGS_JSON="$CLAUDE_DIR/settings.json"
+HOOK_CMD="$HOOKS_DIR/omnish-notify.sh"
+
+INSTALL_HOOKS=1
+INSTALL_SKILL=1
+
+usage() {
+  cat <<EOF
+Usage: $(basename "$0") [options]
+
+Install Omnish Claude Code integration (Stop hook, skill, notify config).
+
+Options:
+  --hooks-only   Install only Stop hook + notify config
+  --skill-only   Install only the omnish Claude skill (+ doctor script)
+  -h, --help     Show this help
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --hooks-only)
+      INSTALL_HOOKS=1
+      INSTALL_SKILL=0
+      shift
+      ;;
+    --skill-only)
+      INSTALL_HOOKS=0
+      INSTALL_SKILL=1
+      shift
+      ;;
+    -h | --help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "error: unknown option: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ "$INSTALL_HOOKS" -eq 1 ]]; then
+  need python3
+  need omnish
+fi
+
+if [[ "$INSTALL_HOOKS" -eq 1 ]]; then
+  mkdir -p "$HOOKS_DIR"
+
+  install -m 755 "$ROOT/hooks/omnish-notify.sh" "$HOOKS_DIR/omnish-notify.sh"
+  install -m 644 "$ROOT/hooks/omnish-notify.py" "$HOOKS_DIR/omnish-notify.py"
+
+  if [[ ! -f "$CLAUDE_DIR/omnish-notify.json" ]]; then
+    install -m 644 "$ROOT/omnish-notify.json.example" "$CLAUDE_DIR/omnish-notify.json"
+    echo "created $CLAUDE_DIR/omnish-notify.json"
+  else
+    echo "kept existing $CLAUDE_DIR/omnish-notify.json"
+  fi
+
+  python3 - "$SETTINGS_JSON" "$HOOK_CMD" <<'PY'
+import json
+import sys
+from pathlib import Path
+
+settings_path = Path(sys.argv[1])
+hook_cmd = sys.argv[2]
+entry = {
+    "hooks": [
+        {
+            "type": "command",
+            "command": hook_cmd,
+        }
+    ]
+}
+
+if settings_path.exists():
+    try:
+        data = json.loads(settings_path.read_text(encoding="utf-8"))
+    except json.JSONDecodeError:
+        data = {}
+else:
+    data = {}
+
+hooks = data.setdefault("hooks", {})
+existing = hooks.get("Stop") or []
+if not isinstance(existing, list):
+    existing = []
+
+found = False
+for group in existing:
+    if not isinstance(group, dict):
+        continue
+    inner = group.get("hooks") or []
+    if any(isinstance(h, dict) and h.get("command") == hook_cmd for h in inner):
+        found = True
+        break
+
+if not found:
+    existing.append(entry)
+    hooks["Stop"] = existing
+    settings_path.parent.mkdir(parents=True, exist_ok=True)
+    settings_path.write_text(json.dumps(data, indent=2) + "\n", encoding="utf-8")
+    print(f"updated {settings_path} (added Stop hook)")
+else:
+    print(f"Stop hook already registered in {settings_path}")
+PY
+fi
+
+if [[ "$INSTALL_SKILL" -eq 1 ]]; then
+  mkdir -p "$SKILL_DIR/scripts"
+  install -m 644 "$ROOT/skill/SKILL.md" "$SKILL_DIR/SKILL.md"
+  install -m 644 "$ROOT/skill/setup-paths.md" "$SKILL_DIR/setup-paths.md"
+  install -m 644 "$ROOT/skill/files-and-sharing.md" "$SKILL_DIR/files-and-sharing.md"
+  install -m 644 "$ROOT/skill/notifications.md" "$SKILL_DIR/notifications.md"
+  install -m 755 "$ROOT/scripts/doctor.sh" "$SKILL_DIR/scripts/doctor.sh"
+  echo "installed skill to $SKILL_DIR"
+fi
+
+cat <<EOF
+
+Installed Omnish Claude Code bundle.
+
+Next steps:
+  1. Ensure omnish gateway is running: omnish run
+  2. Platform attached: omnish config show platform
+     Local mode: omnish link && omnish allow +E164  (or tg:id)
+  3. Restart Claude Code (hooks reload from settings.json)
+  4. Run: bash $SKILL_DIR/scripts/doctor.sh
+
+Config: $CLAUDE_DIR/omnish-notify.json
+Default peer: * (all allowlisted contacts)
+EOF

package/dist/downloads/omnish-claude/uninstall.sh

@@ -0,0 +1,114 @@
+#!/usr/bin/env bash
+# Remove Omnish Claude Code bundle entries from ~/.claude (keeps unrelated hooks).
+set -euo pipefail
+
+CLAUDE_DIR="${CLAUDE_DIR:-$HOME/.claude}"
+SETTINGS_JSON="$CLAUDE_DIR/settings.json"
+HOOK_CMD="$CLAUDE_DIR/hooks/omnish-notify.sh"
+
+REMOVE_HOOKS=1
+REMOVE_SKILL=1
+REMOVE_CONFIG=0
+
+usage() {
+  cat <<EOF
+Usage: $(basename "$0") [options]
+
+Remove Omnish Claude Code integration installed by install.sh.
+
+Options:
+  --hooks-only     Remove Stop hook + hook scripts only
+  --skill-only     Remove ~/.claude/skills/omnish only
+  --with-config    Also delete ~/.claude/omnish-notify.json
+  -h, --help       Show this help
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --hooks-only)
+      REMOVE_HOOKS=1
+      REMOVE_SKILL=0
+      shift
+      ;;
+    --skill-only)
+      REMOVE_HOOKS=0
+      REMOVE_SKILL=1
+      shift
+      ;;
+    --with-config)
+      REMOVE_CONFIG=1
+      shift
+      ;;
+    -h | --help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "error: unknown option: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ "$REMOVE_HOOKS" -eq 1 && -f "$SETTINGS_JSON" ]]; then
+  python3 - "$SETTINGS_JSON" "$HOOK_CMD" <<'PY'
+import json
+import sys
+from pathlib import Path
+
+settings_path = Path(sys.argv[1])
+hook_cmd = sys.argv[2]
+if not settings_path.is_file():
+    raise SystemExit(0)
+data = json.loads(settings_path.read_text(encoding="utf-8"))
+hooks = data.get("hooks") or {}
+existing = hooks.get("Stop") or []
+if not isinstance(existing, list):
+    raise SystemExit(0)
+filtered = []
+changed = False
+for group in existing:
+    if not isinstance(group, dict):
+        filtered.append(group)
+        continue
+    inner = group.get("hooks") or []
+    new_inner = [
+        h for h in inner
+        if not (isinstance(h, dict) and h.get("command") == hook_cmd)
+    ]
+    if len(new_inner) != len(inner):
+        changed = True
+    if new_inner:
+        group = dict(group)
+        group["hooks"] = new_inner
+        filtered.append(group)
+if changed:
+    if filtered:
+        hooks["Stop"] = filtered
+    else:
+        hooks.pop("Stop", None)
+    settings_path.write_text(json.dumps(data, indent=2) + "\n", encoding="utf-8")
+    print(f"updated {settings_path} (removed omnish Stop hook)")
+else:
+    print(f"no omnish Stop hook in {settings_path}")
+PY
+fi
+
+if [[ "$REMOVE_HOOKS" -eq 1 ]]; then
+  rm -f "$CLAUDE_DIR/hooks/omnish-notify.sh" "$CLAUDE_DIR/hooks/omnish-notify.py"
+  echo "removed hook scripts"
+fi
+
+if [[ "$REMOVE_SKILL" -eq 1 ]]; then
+  rm -rf "$CLAUDE_DIR/skills/omnish"
+  echo "removed $CLAUDE_DIR/skills/omnish"
+fi
+
+if [[ "$REMOVE_CONFIG" -eq 1 ]]; then
+  rm -f "$CLAUDE_DIR/omnish-notify.json"
+  echo "removed $CLAUDE_DIR/omnish-notify.json"
+fi
+
+echo "Done. Restart Claude Code if hooks were removed."

package/dist/downloads/omnish-cursor/install.sh

@@ -0,0 +1,162 @@
+#!/usr/bin/env bash
+# Install Omnish Cursor bundle: hooks + skill + rule into ~/.cursor
+set -euo pipefail
+
+OMNISH_CURSOR_BUNDLE_URL="${OMNISH_CURSOR_BUNDLE_URL:-https://omnish.dev/downloads/omnish-cursor.tar.gz}"
+_TMP_BUNDLE_DIR=""
+
+need() {
+  command -v "$1" >/dev/null 2>&1 || {
+    echo "error: required command not found: $1" >&2
+    exit 1
+  }
+}
+
+cleanup() {
+  if [[ -n "$_TMP_BUNDLE_DIR" && -d "$_TMP_BUNDLE_DIR" ]]; then
+    rm -rf "$_TMP_BUNDLE_DIR"
+  fi
+}
+
+_SCRIPT="${BASH_SOURCE[0]:-}"
+if [[ -n "$_SCRIPT" && -f "$_SCRIPT" ]]; then
+  ROOT="$(cd "$(dirname "$_SCRIPT")" && pwd)"
+else
+  need curl
+  need tar
+  _TMP_BUNDLE_DIR="$(mktemp -d "${TMPDIR:-/tmp}/omnish-cursor.XXXXXX")"
+  trap cleanup EXIT
+  echo "Downloading Omnish Cursor bundle..." >&2
+  curl -fsSL "$OMNISH_CURSOR_BUNDLE_URL" | tar -xzf - -C "$_TMP_BUNDLE_DIR"
+  if [[ ! -d "$_TMP_BUNDLE_DIR/omnish-cursor" ]]; then
+    echo "error: bundle missing omnish-cursor/ top-level directory" >&2
+    exit 1
+  fi
+  ROOT="$_TMP_BUNDLE_DIR/omnish-cursor"
+fi
+
+CURSOR_DIR="${CURSOR_DIR:-$HOME/.cursor}"
+HOOKS_DIR="$CURSOR_DIR/hooks"
+RULES_DIR="$CURSOR_DIR/rules"
+SKILL_DIR="$CURSOR_DIR/skills/omnish"
+
+INSTALL_HOOKS=1
+INSTALL_SKILL=1
+
+usage() {
+  cat <<EOF
+Usage: $(basename "$0") [options]
+
+Install Omnish Cursor integration (hooks, skill, rule, config).
+
+Options:
+  --hooks-only   Install only Cursor hooks + rule + notify config
+  --skill-only   Install only the omnish Cursor skill (+ doctor script)
+  -h, --help     Show this help
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --hooks-only)
+      INSTALL_HOOKS=1
+      INSTALL_SKILL=0
+      shift
+      ;;
+    --skill-only)
+      INSTALL_HOOKS=0
+      INSTALL_SKILL=1
+      shift
+      ;;
+    -h | --help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "error: unknown option: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ "$INSTALL_HOOKS" -eq 1 ]]; then
+  need python3
+  need omnish
+fi
+
+if [[ "$INSTALL_HOOKS" -eq 1 ]]; then
+  mkdir -p "$HOOKS_DIR" "$RULES_DIR"
+
+  install -m 755 "$ROOT/hooks/omnish-notify.sh" "$HOOKS_DIR/omnish-notify.sh"
+  install -m 755 "$ROOT/hooks/omnish-session-start.sh" "$HOOKS_DIR/omnish-session-start.sh"
+  install -m 644 "$ROOT/hooks/omnish-notify.py" "$HOOKS_DIR/omnish-notify.py"
+  install -m 644 "$ROOT/rules/omnish-notify.mdc" "$RULES_DIR/omnish-notify.mdc"
+
+  if [[ ! -f "$CURSOR_DIR/omnish-notify.json" ]]; then
+    install -m 644 "$ROOT/omnish-notify.json.example" "$CURSOR_DIR/omnish-notify.json"
+    echo "created $CURSOR_DIR/omnish-notify.json"
+  else
+    echo "kept existing $CURSOR_DIR/omnish-notify.json"
+  fi
+
+  python3 - "$CURSOR_DIR/hooks.json" <<'PY'
+import json
+import sys
+from pathlib import Path
+
+hooks_path = Path(sys.argv[1])
+desired = {
+    "sessionStart": [{"command": "./hooks/omnish-session-start.sh"}],
+    "stop": [{"command": "./hooks/omnish-notify.sh"}],
+}
+
+if hooks_path.exists():
+    try:
+        data = json.loads(hooks_path.read_text(encoding="utf-8"))
+    except json.JSONDecodeError:
+        data = {"version": 1, "hooks": {}}
+else:
+    data = {"version": 1, "hooks": {}}
+
+data.setdefault("version", 1)
+hooks = data.setdefault("hooks", {})
+
+for event, entries in desired.items():
+    existing = hooks.get(event) or []
+    commands = {entry.get("command") for entry in existing if isinstance(entry, dict)}
+    merged = list(existing)
+    for entry in entries:
+        if entry["command"] not in commands:
+            merged.append(entry)
+    hooks[event] = merged
+
+hooks_path.write_text(json.dumps(data, indent=2) + "\n", encoding="utf-8")
+print(f"updated {hooks_path}")
+PY
+fi
+
+if [[ "$INSTALL_SKILL" -eq 1 ]]; then
+  mkdir -p "$SKILL_DIR/scripts"
+  install -m 644 "$ROOT/skill/SKILL.md" "$SKILL_DIR/SKILL.md"
+  install -m 644 "$ROOT/skill/setup-paths.md" "$SKILL_DIR/setup-paths.md"
+  install -m 644 "$ROOT/skill/files-and-sharing.md" "$SKILL_DIR/files-and-sharing.md"
+  install -m 644 "$ROOT/skill/notifications.md" "$SKILL_DIR/notifications.md"
+  install -m 755 "$ROOT/scripts/doctor.sh" "$SKILL_DIR/scripts/doctor.sh"
+  echo "installed skill to $SKILL_DIR"
+fi
+
+cat <<EOF
+
+Installed Omnish Cursor bundle.
+
+Next steps:
+  1. Ensure omnish gateway is running: omnish run
+  2. Platform attached: omnish config show platform
+     Local mode: omnish link && omnish allow +E164  (or tg:id)
+  3. Restart Cursor (or reload Hooks in Settings)
+  4. Run: bash $SKILL_DIR/scripts/doctor.sh
+
+Config: $CURSOR_DIR/omnish-notify.json
+Default peer: * (all allowlisted contacts)
+EOF