omnish 1.6.6 → 2.0.0

package/CHANGELOG.md

@@ -7,6 +7,38 @@ 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

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).
@@ -157,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 …`**.
 
@@ -266,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

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

@@ -0,0 +1,107 @@
+#!/usr/bin/env bash
+# Remove Omnish Cursor bundle entries from ~/.cursor (keeps unrelated hooks).
+set -euo pipefail
+
+CURSOR_DIR="${CURSOR_DIR:-$HOME/.cursor}"
+HOOKS_JSON="$CURSOR_DIR/hooks.json"
+
+REMOVE_HOOKS=1
+REMOVE_SKILL=1
+REMOVE_CONFIG=0
+
+usage() {
+  cat <<EOF
+Usage: $(basename "$0") [options]
+
+Remove Omnish Cursor integration installed by install.sh.
+
+Options:
+  --hooks-only     Remove hooks + rule + hooks.json entries only
+  --skill-only     Remove ~/.cursor/skills/omnish only
+  --with-config    Also delete ~/.cursor/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
+
+OMNISH_COMMANDS=(
+  "./hooks/omnish-session-start.sh"
+  "./hooks/omnish-notify.sh"
+)
+
+if [[ "$REMOVE_HOOKS" -eq 1 && -f "$HOOKS_JSON" ]]; then
+  python3 - "$HOOKS_JSON" "${OMNISH_COMMANDS[@]}" <<'PY'
+import json
+import sys
+from pathlib import Path
+
+hooks_path = Path(sys.argv[1])
+remove_cmds = set(sys.argv[2:])
+data = json.loads(hooks_path.read_text(encoding="utf-8"))
+hooks = data.get("hooks") or {}
+changed = False
+for event, entries in list(hooks.items()):
+    if not isinstance(entries, list):
+        continue
+    filtered = [
+        e for e in entries
+        if not (isinstance(e, dict) and e.get("command") in remove_cmds)
+    ]
+    if len(filtered) != len(entries):
+        changed = True
+        hooks[event] = filtered
+if changed:
+    hooks_path.write_text(json.dumps(data, indent=2) + "\n", encoding="utf-8")
+    print(f"updated {hooks_path} (removed omnish hook entries)")
+else
+    print(f"no omnish hook entries in {hooks_path}")
+PY
+fi
+
+if [[ "$REMOVE_HOOKS" -eq 1 ]]; then
+  rm -f \
+    "$CURSOR_DIR/hooks/omnish-notify.sh" \
+    "$CURSOR_DIR/hooks/omnish-notify.py" \
+    "$CURSOR_DIR/hooks/omnish-session-start.sh" \
+    "$CURSOR_DIR/rules/omnish-notify.mdc"
+  echo "removed hook scripts and omnish-notify rule"
+fi
+
+if [[ "$REMOVE_SKILL" -eq 1 ]]; then
+  rm -rf "$CURSOR_DIR/skills/omnish"
+  echo "removed $CURSOR_DIR/skills/omnish"
+fi
+
+if [[ "$REMOVE_CONFIG" -eq 1 ]]; then
+  rm -f "$CURSOR_DIR/omnish-notify.json"
+  echo "removed $CURSOR_DIR/omnish-notify.json"
+fi
+
+echo "Done. Restart Cursor if hooks were removed."