omnish 1.6.6 → 2.0.0

package/dist/omnish-claude/README.md

@@ -0,0 +1,80 @@
+# Omnish Claude Code integration
+
+Install Omnish in Claude Code for file sharing, mobile notifications, and Done briefs when the agent finishes useful work.
+
+Works with any Omnish setup (standalone WhatsApp/Telegram or platform attached mode).
+
+## Quick install
+
+**Offline (bundled with omnish — no omnish.dev):**
+
+```bash
+omnish agents install claude
+omnish agents install all
+```
+
+From allowlisted chat (when `agentInstallFromChat` is enabled):
+
+```text
+/agents install claude
+/agents install all
+```
+
+**Online (curl):**
+
+```bash
+curl -fsSL https://omnish.dev/downloads/omnish-claude/install.sh | bash
+```
+
+From a local omnish clone:
+
+```bash
+bash contrib/omnish-claude/install.sh
+```
+
+Partial install:
+
+```bash
+./install.sh --hooks-only   # Stop hook + notify config
+./install.sh --skill-only   # Claude skill + doctor script only
+```
+
+Requires: **Claude Code**, **python3**, **omnish** on `PATH` for hooks install.
+
+## What it installs
+
+| Path                                        | Purpose                            |
+| ------------------------------------------- | ---------------------------------- |
+| `~/.claude/skills/omnish/SKILL.md`          | Setup/usage skill for Claude       |
+| `~/.claude/skills/omnish/scripts/doctor.sh` | Health check script                |
+| `~/.claude/hooks/omnish-notify.py`          | Stop-hook logic                    |
+| `~/.claude/hooks/omnish-notify.sh`          | Stop hook wrapper                  |
+| `~/.claude/omnish-notify.json`              | Notify config (created if missing) |
+| `~/.claude/settings.json`                   | Merges `Stop` hook entry           |
+
+Restart Claude Code after install.
+
+## Verify
+
+```bash
+omnish agents doctor claude
+# or: bash ~/.claude/skills/omnish/scripts/doctor.sh
+```
+
+## Notify config
+
+Same schema as Cursor — see [contrib/omnish-cursor/README.md](../omnish-cursor/README.md).
+
+## Uninstall
+
+```bash
+omnish agents uninstall claude
+# or: bash contrib/omnish-claude/uninstall.sh
+# or: curl -fsSL https://omnish.dev/downloads/omnish-claude/uninstall.sh | bash
+```
+
+Add `--with-config` to remove notify json.
+
+## License
+
+Same as omnish (MIT).

package/dist/omnish-claude/hooks/omnish-notify.py

@@ -0,0 +1,213 @@
+#!/usr/bin/env python3
+"""Claude Code Stop hook: send a curated Omnish brief when agent work is worth notifying."""
+
+from __future__ import annotations
+
+import json
+import os
+import re
+import subprocess
+import sys
+from pathlib import Path
+from typing import Any
+
+CONFIG_PATH = Path.home() / ".claude" / "omnish-notify.json"
+LOG_PATH = Path.home() / ".claude" / "hooks" / "omnish-notify.log"
+
+
+def log(message: str) -> None:
+    try:
+        LOG_PATH.parent.mkdir(parents=True, exist_ok=True)
+        with LOG_PATH.open("a", encoding="utf-8") as handle:
+            handle.write(message.rstrip() + "\n")
+    except OSError:
+        pass
+
+
+def load_config() -> dict[str, Any]:
+    defaults: dict[str, Any] = {
+        "enabled": True,
+        "peer": os.environ.get("OMNISH_CLAUDE_NOTIFY_PEER", "*"),
+        "min_assistant_chars": 120,
+        "notify_on_error": True,
+        "skip_aborted": True,
+        "include_full_chat_id": True,
+    }
+    if CONFIG_PATH.exists():
+        try:
+            defaults.update(json.loads(CONFIG_PATH.read_text(encoding="utf-8")))
+        except (OSError, json.JSONDecodeError) as exc:
+            log(f"config read failed: {exc}")
+    return defaults
+
+
+def summarize_text(text: str, limit: int = 320) -> str:
+    compact = re.sub(r"\s+", " ", text).strip()
+    if len(compact) <= limit:
+        return compact
+    return compact[: limit - 1].rstrip() + "…"
+
+
+def count_tool_uses(transcript_path: str | None) -> tuple[int, int]:
+    if not transcript_path:
+        return 0, 0
+    path = Path(transcript_path)
+    if not path.is_file():
+        return 0, 0
+    tool_count = 0
+    action_count = 0
+    action_names = {"Bash", "Write", "Edit", "MultiEdit", "NotebookEdit", "Task"}
+    try:
+        for line in path.read_text(encoding="utf-8", errors="replace").splitlines():
+            line = line.strip()
+            if not line:
+                continue
+            try:
+                entry = json.loads(line)
+            except json.JSONDecodeError:
+                continue
+            if entry.get("type") != "assistant":
+                continue
+            message = entry.get("message") or {}
+            content = message.get("content")
+            if not isinstance(content, list):
+                continue
+            for item in content:
+                if not isinstance(item, dict):
+                    continue
+                if item.get("type") in ("tool_use", "toolUse"):
+                    tool_count += 1
+                    name = item.get("name") or item.get("tool_name")
+                    if name in action_names:
+                        action_count += 1
+    except OSError as exc:
+        log(f"transcript read failed: {exc}")
+    return tool_count, action_count
+
+
+def should_notify(payload: dict[str, Any], cfg: dict[str, Any]) -> bool:
+    if payload.get("stop_hook_active"):
+        return False
+
+    event = str(payload.get("hook_event_name") or "Stop")
+    if event == "StopFailure" and cfg.get("notify_on_error"):
+        return True
+
+    last_msg = str(payload.get("last_assistant_message") or "")
+    assistant_chars = len(last_msg)
+    tool_count, action_count = count_tool_uses(payload.get("transcript_path"))
+
+    if action_count > 0:
+        return True
+    if tool_count >= 2:
+        return True
+
+    min_chars = int(cfg.get("min_assistant_chars") or 120)
+    if assistant_chars >= min_chars:
+        return True
+
+    return False
+
+
+def build_message(payload: dict[str, Any], cfg: dict[str, Any]) -> tuple[str, str] | None:
+    event = str(payload.get("hook_event_name") or "Stop")
+    session_id = str(payload.get("session_id") or payload.get("sessionId") or "").strip()
+    cwd = str(payload.get("cwd") or payload.get("working_directory") or "").strip()
+    last_msg = summarize_text(str(payload.get("last_assistant_message") or ""), 320)
+
+    if event == "StopFailure":
+        title = "Claude Error"
+    else:
+        title = "Claude Done"
+
+    parts: list[str] = []
+    if cfg.get("include_full_chat_id", True) and session_id:
+        parts.append(f"session {session_id}")
+    elif session_id:
+        parts.append(f"session {session_id[:8]}")
+
+    if cwd:
+        parts.append(f"cwd {Path(cwd).name}")
+
+    if last_msg:
+        parts.append(f"result: {last_msg}")
+    elif event == "StopFailure":
+        parts.append(f"result: {summarize_text(str(payload.get('error') or 'API error'), 160)}")
+    else:
+        parts.append("result: agent finished")
+
+    brief = " | ".join(parts)
+    if not brief.strip():
+        return None
+    return title, brief
+
+
+def send_notification(title: str, brief: str, peer: str) -> None:
+    destination = (peer or "*").strip() or "*"
+    env = os.environ.copy()
+    if destination != "*":
+        env["OMNISH_PEER_KEY"] = destination
+    inner = f"/sendto {destination} -t {title} -- {brief}"
+    subprocess.run(
+        ["omnish", "i", "-c", inner],
+        check=False,
+        env=env,
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+        timeout=30,
+    )
+
+
+def which(name: str) -> str | None:
+    for directory in os.environ.get("PATH", "").split(os.pathsep):
+        candidate = Path(directory) / name
+        if candidate.is_file() and os.access(candidate, os.X_OK):
+            return str(candidate)
+    return None
+
+
+def main() -> int:
+    try:
+        payload = json.load(sys.stdin)
+    except json.JSONDecodeError as exc:
+        log(f"invalid hook payload: {exc}")
+        print("{}")
+        return 0
+
+    cfg = load_config()
+    if not cfg.get("enabled", True):
+        print("{}")
+        return 0
+
+    if not should_notify(payload, cfg):
+        log(f"skip notify event={payload.get('hook_event_name')} session={payload.get('session_id')}")
+        print("{}")
+        return 0
+
+    message = build_message(payload, cfg)
+    if not message:
+        print("{}")
+        return 0
+
+    title, brief = message
+    peer = str(cfg.get("peer") or "*").strip() or "*"
+
+    if not which("omnish"):
+        log("omnish not found on PATH")
+        print("{}")
+        return 0
+
+    try:
+        send_notification(title, brief, peer)
+        log(f"sent session={payload.get('session_id')} dest={peer!r} title={title!r}")
+    except subprocess.TimeoutExpired:
+        log(f"notify timeout session={payload.get('session_id')}")
+    except OSError as exc:
+        log(f"notify failed: {exc}")
+
+    print("{}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/dist/omnish-claude/hooks/omnish-notify.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Claude Code Stop hook: send curated Omnish brief when work is worth notifying.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PYTHON="${OMNISH_NOTIFY_PYTHON:-python3}"
+
+if ! command -v "$PYTHON" >/dev/null 2>&1; then
+  echo '{}'
+  exit 0
+fi
+
+exec "$PYTHON" "$SCRIPT_DIR/omnish-notify.py"

package/dist/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/omnish-claude/omnish-notify.json.example

@@ -0,0 +1,8 @@
+{
+  "enabled": true,
+  "peer": "*",
+  "min_assistant_chars": 120,
+  "notify_on_error": true,
+  "skip_aborted": true,
+  "include_full_chat_id": true
+}

package/dist/omnish-claude/scripts/doctor.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+# Read-only Omnish + Claude Code integration health check.
+set -euo pipefail
+
+CLAUDE_DIR="${CLAUDE_DIR:-$HOME/.claude}"
+WARN=0
+
+ok() { printf '  OK   %s\n' "$*"; }
+warn() { printf '  WARN %s\n' "$*"; WARN=1; }
+fail() { printf '  FAIL %s\n' "$*"; }
+
+section() { printf '\n== %s ==\n' "$*"; }
+
+section "Omnish CLI"
+if command -v omnish >/dev/null 2>&1; then
+  ok "omnish on PATH: $(command -v omnish)"
+  omnish --version 2>/dev/null | sed 's/^/       /' || true
+else
+  fail "omnish not found — run: npm install -g omnish"
+  exit 1
+fi
+
+section "Gateway status"
+if omnish status 2>&1 | sed 's/^/  /'; then
+  if omnish status 2>&1 | grep -q 'gateway process: running'; then
+    ok "gateway running"
+  else
+    warn "gateway not running — run: omnish run  (or omnish start)"
+  fi
+else
+  warn "omnish status failed"
+fi
+
+section "Claude notify config"
+CFG="$CLAUDE_DIR/omnish-notify.json"
+if [[ -f "$CFG" ]]; then
+  ok "found $CFG"
+  python3 - "$CFG" <<'PY'
+import json, sys
+cfg = json.load(open(sys.argv[1], encoding="utf-8"))
+enabled = cfg.get("enabled", True)
+peer = cfg.get("peer", "*")
+print(f"       enabled={enabled} peer={peer!r}")
+PY
+else
+  warn "missing $CFG — run: omnish agents install claude"
+fi
+
+section "Claude hooks"
+HOOK_CMD="$CLAUDE_DIR/hooks/omnish-notify.sh"
+for f in omnish-notify.sh omnish-notify.py; do
+  if [[ -f "$CLAUDE_DIR/hooks/$f" ]]; then
+    ok "hook file: hooks/$f"
+  else
+    warn "missing hooks/$f"
+  fi
+done
+
+SETTINGS="$CLAUDE_DIR/settings.json"
+if [[ -f "$SETTINGS" ]]; then
+  python3 - "$SETTINGS" "$HOOK_CMD" <<'PY'
+import json, sys
+from pathlib import Path
+data = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))
+hook_cmd = sys.argv[2]
+groups = (data.get("hooks") or {}).get("Stop") or []
+found = False
+for group in groups:
+    if not isinstance(group, dict):
+        continue
+    for h in group.get("hooks") or []:
+        if isinstance(h, dict) and h.get("command") == hook_cmd:
+            found = True
+print(f"       Stop hook: {'registered' if found else 'MISSING ' + hook_cmd}")
+PY
+else
+  warn "missing $SETTINGS"
+fi
+
+section "Claude skill"
+SKILL="$CLAUDE_DIR/skills/omnish/SKILL.md"
+if [[ -f "$SKILL" ]]; then
+  ok "skill installed: skills/omnish/SKILL.md"
+else
+  warn "skill not installed — run: omnish agents install claude"
+fi
+
+section "Suggested next steps"
+if [[ $WARN -eq 0 ]]; then
+  echo "  All checks passed. Test notify:"
+  echo "    omnish i -c '/sendto * -t Omnish Test -- claude doctor ok'"
+else
+  echo "  Fix WARN items above, then:"
+  echo "    omnish run"
+  echo "    omnish agents install claude"
+  echo "    omnish i -c '/sendto * -t Omnish Test -- setup ok'"
+fi
+
+exit 0

package/dist/omnish-claude/skill/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: omnish
+description: Install, configure, and use Omnish (WhatsApp/Telegram/platform shell gateway)—chat commands, file sharing (/send, /sendto, /receive), and mobile notifications. Use when setting up omnish, omnish run, platform token, file transfer, agent notify, or Claude Code omnish hooks.
+---
+
+# Omnish setup and usage (Claude Code)
+
+Help the user install, configure, and use **omnish** — a messaging-to-shell gateway (WhatsApp, Telegram, or platform attached mode). Chat is the primary UX; emphasize **file sharing** and **notifications** as high-value extras.
+
+## First step: triage
+
+Run the bundled doctor (after install) or from the repo:
+
+```bash
+bash ~/.claude/skills/omnish/scripts/doctor.sh
+# or: bash contrib/omnish-claude/scripts/doctor.sh
+# or: omnish agents doctor claude
+```
+
+Interpret output: omnish on PATH, gateway running, allowlist/platform token, Claude Stop hook + skill installed. Never echo secrets from config.
+
+## Install without omnish.dev
+
+From chat (when enabled): `/agents install claude`
+
+From terminal:
+
+```bash
+omnish agents install claude
+# or: bash contrib/omnish-claude/install.sh
+```
+
+See [setup-paths.md](setup-paths.md), [files-and-sharing.md](files-and-sharing.md), and [notifications.md](notifications.md) for the full reference (shared with Cursor bundle).
+
+## Claude automatic notifications
+
+Stop hook sends curated briefs when agent work is substantive. Config: `~/.claude/omnish-notify.json` (same keys as Cursor).
+
+Manual notify from scripts or `/run` / `/apps`: see [notifications.md](notifications.md).