Skip to content

Business operating system for Claude Code — 57 skills, 21 agents, smart daemon. Unified inbox (WhatsApp/Email/Slack/Telegram), autonomous PR merge, full-AWS monitoring, revenue (Stripe+RevenueCat), e-commerce (Shopify), marketing (Klaviyo/Meta/GA4), voice (Bland/ElevenLabs), APM (Datadog/NewRelic/OTEL), YOLO mode.

docs: update README + CHANGELOG for wacli decommission

auroracapital48d6c8f97e02
diff --git a/claude-ops/CHANGELOG.md b/claude-ops/CHANGELOG.md
index 399b9158..9b7595a7 100644
--- a/claude-ops/CHANGELOG.md
+++ b/claude-ops/CHANGELOG.md
@@ -2,6 +2,37 @@
All notable changes to this project will be documented in this file.
+## [Unreleased] — 2026-04-27
+
+### Changed
+
+- **Decommission wacli daemon. WhatsApp ops now Baileys-only via `mcp__whatsapp__*`.** Migration script in `scripts/whatsapp-bridge-migrate.sh`.
+ - All skill references to `wacli chats list`, `wacli messages list/search`, `wacli contacts --search`, `wacli send`, `wacli history backfill`, and `wacli doctor` replaced with `mcp__whatsapp__*` tool calls or direct `sqlite3` queries against the bridge `messages.db`.
+ - `scripts/wacli-keepalive.sh` and `scripts/com.claude-ops.wacli-keepalive.plist` moved to `legacy/` (preserved for reference).
+ - `bin/wacli-health` rewritten to check bridge port 8080 and launchd status.
+ - `bin/wacli-safe` replaced with a deprecation shim.
+ - New `bin/ops-pretool-whatsapp-bridge-health` PreToolUse hook for bridge liveness.
+ - New `assets/launchagents/com.<user>.whatsapp-bridge.plist` template.
+ - `scripts/whatsapp-bridge-migrate.sh`: idempotent FTS5 virtual table + contacts table migration for `messages.db`; seeds contacts from macOS Contacts.app via osascript.
+
+### Migration steps (manual, post-merge)
+
+1. Run `scripts/whatsapp-bridge-migrate.sh` to add FTS5 index and contacts table to bridge `messages.db`.
+2. Revoke the wacli linked device on your phone (WhatsApp → Settings → Linked Devices).
+3. `launchctl bootout gui/$UID ~/Library/LaunchAgents/com.claude-ops.wacli-keepalive.plist 2>/dev/null || true`
+4. `rm -f ~/Library/LaunchAgents/com.claude-ops.wacli-keepalive.plist`
+
+### Rollback
+
+WhatsApp supports 4 linked devices. Re-link wacli at any time:
+```bash
+wacli auth # scan QR
+launchctl bootstrap gui/$UID ~/Library/LaunchAgents/com.claude-ops.wacli-keepalive.plist
+```
+History from before rollback won't be in new wacli store, but bridge keeps running independently — no message loss.
+
+---
+
## [2.0.0] — 2026-04-26
> **Major release.** Purely additive — no behavior of any v1.x skill changes by default. Existing users can upgrade in place. Every new subsystem is gated by a `userConfig` toggle (defaults documented per-feature below) and can be turned off from `/plugins` settings without uninstalling. See [`docs/migrating-from-v1.md`](docs/migrating-from-v1.md) and the [Migrating-from-v1 wiki page](https://github.com/Lifecycle-Innovations-Limited/claude-ops/wiki/Migrating-from-v1).
diff --git a/claude-ops/README.md b/claude-ops/README.md
index 29d24b87..22ba0b8e 100644
--- a/claude-ops/README.md
+++ b/claude-ops/README.md
@@ -123,7 +123,7 @@ Full feature parity with the legacy v1 bash script: `--gpu` reports GPU + Neural
The background memory extractor now prefers the Claude Code OAuth token stored in macOS Keychain (`Claude Code-credentials`) over `ANTHROPIC_API_KEY`. Calls are billed against your Claude Max subscription instead of your API credit. The token is never exported to the shell environment, so parent terminal sessions stay unaffected. Falls back to `ANTHROPIC_API_KEY` (env → keychain → Doppler).
### Persistent WhatsApp follower
-`scripts/wacli-keepalive.sh` now keeps `wacli --follow` alive indefinitely. Previously the supervisor invoked `wacli sync --once` on the first tick before `--follow` had stabilized its store lock, which tore down the persistent connection every 5-20 minutes. Fixed via `INITIAL_BACKFILL_DELAY=30` plus a reentrant guard against overlapping sweeps.
+`whatsapp-bridge` (Baileys) now manages WhatsApp connectivity via the `com.<user>.whatsapp-bridge` LaunchAgent. Previously `whatsapp-bridge-keepalive.sh` kept `whatsapp-bridge --follow` alive — that daemon has been decommissioned (see `legacy/`). Which tore down the persistent connection every 5-20 minutes. Fixed via `INITIAL_BACKFILL_DELAY=30` plus a reentrant guard against overlapping sweeps.
### Full Plugin Feature Adoption
- All 30 skills: `effort`, `maxTurns`, `disallowedTools`, `model` annotations
@@ -149,7 +149,7 @@ The setup wizard (`/ops:setup`) walks through each one interactively. You choose
|------|---------------|--------------|
| `gh` (GitHub CLI) | Yes (Homebrew) | PRs, CI logs, issue triage, merge pipeline — used by 8+ skills |
| `aws` (AWS CLI) | Yes (Homebrew) | ECS health, Cost Explorer, CloudWatch — used by ops-fires, ops-revenue, ops-deploy |
-| `wacli` (WhatsApp) | Manual ([source](https://github.com/Lifecycle-Innovations-Limited/wacli)) | WhatsApp inbox, send/read, contact lookup — no MCP equivalent exists |
+| `whatsapp-bridge` (WhatsApp) | Bundled ([source](https://github.com/your-org/whatsapp-mcp)) | WhatsApp inbox, send/read, contact lookup via `mcp__whatsapp__*` tools |
| Node.js 18+ | Yes (Homebrew) | Runs the bundled Telegram MCP server |
#### MCP-only (no CLI needed)
@@ -341,7 +341,7 @@ After the report, type `YOLO` to hand over the controls — Claude will autonomo
┌─────────────────────────┼────────────────────────┐
│ ops-daemon (launchd) │
│ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │
-│ │ wacli │ │ memory │ │ brain layer │ │
+│ │ bridge │ │ memory │ │ brain layer │ │
│ │ sync │ │ extractor│ │ briefing cache │ │
│ │ (follow) │ │ (cron) │ │ urgent detect │ │
│ └──────────┘ └──────────┘ └──────────────────┘ │
diff --git a/claude-ops/docs/INDEX.md b/claude-ops/docs/INDEX.md
index e043d154..d3ce1d87 100644
--- a/claude-ops/docs/INDEX.md
+++ b/claude-ops/docs/INDEX.md
@@ -26,7 +26,7 @@
|-----|---------|
| [`agents-reference.md`](agents-reference.md) | Catalog of all 18 agents (4 v2 specialists + 14 v1 scanners/fixers/C-suite). |
| [`skills-reference.md`](skills-reference.md) | Catalog of all 33+ skills with usage examples. |
-| [`daemon-guide.md`](daemon-guide.md) | The v1 ops-daemon (briefing pre-warm, wacli-sync, memory-extractor, etc). |
+| [`daemon-guide.md`](daemon-guide.md) | The v1 ops-daemon (briefing pre-warm, whatsapp-bridge-sync, memory-extractor, etc). |
| [`docker.md`](docker.md) | Running claude-ops in a container. |
| [`marketplace-submissions.md`](marketplace-submissions.md) | Publishing your own plugin to the same marketplace. |
| [`memories-system.md`](memories-system.md) | The cross-session memory system used by agents. |
diff --git a/claude-ops/docs/daemon-guide.md b/claude-ops/docs/daemon-guide.md
index 8395073c..90f27f68 100644
--- a/claude-ops/docs/daemon-guide.md
+++ b/claude-ops/docs/daemon-guide.md
@@ -30,7 +30,7 @@ The daemon supervises **seven** long-lived services:
| Service | Cadence | Purpose |
|---------|---------|---------|
| `briefing-pre-warm` | every **2 min** | Runs `bin/ops-gather` to keep `/ops:go` cache hot |
-| `wacli-sync` | persistent | Keeps WhatsApp connected, auto-reconnects, backfills `@lid` chats |
+| `whatsapp-bridge-sync` | persistent | Keeps WhatsApp connected, auto-reconnects, backfills `@lid` chats |
| `memory-extractor` | every 30 min | Spawns `memory-extractor` agent to refresh `memories/` |
| `inbox-digest` | every 15 min | Pre-classifies comms across channels for `/ops:inbox` |
| `store-health` | every 10 min | Shopify orders + inventory polling (if configured) |
@@ -125,7 +125,7 @@ The daemon script lives at `scripts/ops-daemon.sh`.
## 📋 Health File Contract
-The daemon writes `~/.wacli/.health` on every successful wacli sync. Skills read this file before any WhatsApp operation.
+The daemon writes `~/.whatsapp-bridge/.health` on every successful whatsapp-bridge sync. Skills read this file before any WhatsApp operation.
```json
{
@@ -139,8 +139,8 @@ The daemon writes `~/.wacli/.health` on every successful wacli sync. Skills read
| Field | Meaning |
|-------|---------|
| `status` | `ok`, `degraded`, or `down` |
-| `last_sync` | ISO timestamp of last successful wacli poll |
-| `wacli_pid` | PID of the running wacli process |
+| `last_sync` | ISO timestamp of last successful whatsapp-bridge poll |
+| `wacli_pid` | PID of the running whatsapp-bridge process |
| `message_count` | Total messages in local DB |
> [!WARNING]
@@ -150,7 +150,7 @@ The daemon writes `~/.wacli/.health` on every successful wacli sync. Skills read
## 🪝 PreToolUse Hook
-`hooks/whatsapp-health-check.sh` runs automatically before any `wacli` call. It checks the health file and either:
+`hooks/whatsapp-health-check.sh` runs automatically before any `whatsapp-bridge` call. It checks the health file and either:
- Proceeds silently if `status === ok` and `last_sync` is recent
- Surfaces a warning with instructions to restart the daemon if degraded
@@ -191,7 +191,7 @@ Common issues:
| Symptom | Likely cause | Fix |
|---------|--------------|-----|
-| `wacli not connected` | Auth expired | `/ops:setup whatsapp` to re-authenticate |
+| `whatsapp-bridge not connected` | Auth expired | `/ops:setup whatsapp` to re-authenticate |
| `health file stale` | Daemon crashed | Check `/tmp/com.claude-ops.daemon.log`, restart via launchctl |
| `memory extractor not running` | Missing Haiku API key | Configure in preferences or Doppler |
| `briefing-pre-warm errors` | `bin/ops-gather` failing | Run `bin/ops-gather` manually to see the error, often a missing CLI |
diff --git a/claude-ops/docs/memories-system.md b/claude-ops/docs/memories-system.md
index 1edb815d..5e6ea0d2 100644
--- a/claude-ops/docs/memories-system.md
+++ b/claude-ops/docs/memories-system.md
@@ -16,13 +16,13 @@
The memories system gives claude-ops persistent context about people, projects, and your communication patterns. Introduced in v0.5.0, upgraded in v1.1.0 with richer project context blocks.
> [!IMPORTANT]
-> **Files never leave your machine.** Memories are plain markdown on your local disk at `~/.claude/plugins/data/ops-ops-marketplace/memories/`. The extractor reads your local wacli database and local email cache — nothing is uploaded. See [Privacy](#-privacy) below.
+> **Files never leave your machine.** Memories are plain markdown on your local disk at `~/.claude/plugins/data/ops-ops-marketplace/memories/`. The extractor reads your local whatsapp-bridge database and local email cache — nothing is uploaded. See [Privacy](#-privacy) below.
---
## 🧠 How It Works
-1. **Extraction** — the `memory-extractor` agent (`agents/memory-extractor.md`) runs every 30 minutes as a daemon service. It reads recent WhatsApp messages (via `wacli`) and email threads (via `gog`) and calls Claude Haiku to extract structured profiles.
+1. **Extraction** — the `memory-extractor` agent (`agents/memory-extractor.md`) runs every 30 minutes as a daemon service. It reads recent WhatsApp messages (via `whatsapp-bridge`) and email threads (via `gog`) and calls Claude Haiku to extract structured profiles.
2. **Storage** — profiles are written as markdown files to `~/.claude/plugins/data/ops-ops-marketplace/memories/`.
3. **Consumption** — skills load the relevant memory files at runtime via the Runtime Context block at the top of each `SKILL.md`.
@@ -36,10 +36,10 @@ flowchart TB
Trigger -->|/ops:doctor --run-memory-extractor| Start
Start --> ReadLocal[Read LOCAL sources only]
- ReadLocal --> Wacli[(~/.wacli<br/>local SQLite)]
+ ReadLocal --> Bridge[(~/.whatsapp-bridge<br/>local SQLite)]
ReadLocal --> Gog[(~/.gog<br/>local email cache)]
- Wacli --> Haiku[Claude Haiku 4.5<br/>structured extraction]
+ Bridge --> Haiku[Claude Haiku 4.5<br/>structured extraction]
Gog --> Haiku
Haiku --> Merge[Merge into existing<br/>profiles — never overwrite]
@@ -64,7 +64,7 @@ flowchart TB
class Trigger,ReadLocal primary
class Start,Haiku agent
- class Wacli,Gog,Contacts,Prefs,Projects daemon
+ class Bridge,Gog,Contacts,Prefs,Projects daemon
class Consumed,Inbox,Comms,Go success
```
@@ -182,7 +182,7 @@ The daemon triggers extraction when **any** of these conditions are met:
| Trigger | Condition |
|---------|-----------|
| Time-based | 30 minutes elapsed since last run |
-| Volume-based | Message count in `~/.wacli/.health` increased by more than 5 |
+| Volume-based | Message count in `~/.whatsapp-bridge/.health` increased by more than 5 |
| Manual | `/ops:doctor --run-memory-extractor` |
The extractor uses `claude-haiku-4-5-20251001` (fast + cheap) for all extraction work. It merges new information into existing profiles rather than overwriting, so context accumulates over time.
@@ -199,7 +199,7 @@ The extractor uses `claude-haiku-4-5-20251001` (fast + cheap) for all extraction
>
> - **Location:** `~/.claude/plugins/data/ops-ops-marketplace/memories/`
> - **Storage:** plain markdown files on your local disk
-> - **Sources:** the extractor reads your **local** wacli database and **local** email cache — not cloud APIs
+> - **Sources:** the extractor reads your **local** whatsapp-bridge database and **local** email cache — not cloud APIs
> - **Upload:** nothing is sent to any server. Files are read by skills at runtime and that's it.
>
> If you want to wipe everything: `rm -rf ~/.claude/plugins/data/ops-ops-marketplace/memories/`.
diff --git a/claude-ops/docs/migrating-from-v1.md b/claude-ops/docs/migrating-from-v1.md
index 6beca120..f6df8541 100644
--- a/claude-ops/docs/migrating-from-v1.md
+++ b/claude-ops/docs/migrating-from-v1.md
@@ -30,7 +30,7 @@ That's it. Existing settings, registries, preferences, and daemon services are u
| Skills | 30 | 33+ (added `/ops:deploy-fix`, `/ops:recap`, `/ops:rotate`, `/ops:rotate-setup`) |
| Agents | 14 | 18 (added `general-purpose` override, `deploy-fixer`, `build-fixer`, `dependency-auditor`) |
| PostToolUse:Bash hooks | 0 | 3 (deploy-fix-merge, deploy-fix-build, task-reminder) |
-| PreToolUse:Bash hooks | 1 (wacli-health) | 4 (+ secret-commit, no-rm-rf-anchor, warn-mainpush) |
+| PreToolUse:Bash hooks | 1 (whatsapp-bridge-health) | 4 (+ secret-commit, no-rm-rf-anchor, warn-mainpush) |
| PreToolUse:Agent hooks | 0 | 1 (specialized-agent suggestion) |
| Daemons | 1 (ops-daemon, 7 services) | 3 (+ recap-daemon, account-rotation-daemon) |
| `userConfig` toggles | ~25 string entries | 44 (19+ new booleans/numbers/file pickers) |
diff --git a/claude-ops/docs/os-compatibility.md b/claude-ops/docs/os-compatibility.md
index 724bb5ff..4f393b5c 100644
--- a/claude-ops/docs/os-compatibility.md
+++ b/claude-ops/docs/os-compatibility.md
@@ -73,11 +73,11 @@ Tokens are stored via the credential cascade (see below). Service names: `slack-
`bin/ops-telegram-autolink.mjs` uses gram.js to capture an MTProto session string. Works identically on every OS — the only platform difference is where the credentials are persisted (cred cascade). Service names: `telegram-api-id`, `telegram-api-hash`, `telegram-phone`, `telegram-session`.
-### WhatsApp — `wacli`
+### WhatsApp — `whatsapp-bridge`
| OS | Status | Notes |
|---|---|---|
-| macOS | Tier 1 | `wacli` builds from source: `git clone … && go build -o /usr/local/bin/wacli ./cmd/wacli` |
+| macOS | Tier 1 | `whatsapp-bridge` builds from source: `git clone … && go build -o /usr/local/bin/whatsapp-bridge ./cmd/whatsapp-bridge` |
| Linux | Tier 1 | Same build flow; install Go first: `apt-get install -y golang` etc. |
| WSL2 | Tier 1 | Same as Linux. |
| Windows | Tier 3 | Build under WSL — native Windows builds untested. |
@@ -157,8 +157,8 @@ Backend names: `security`, `secret-tool`, `wincred`, `keytar`, `enc-json`, `plai
| OS | Mechanism | Files written |
|---|---|---|
-| macOS | `launchd` user agent | `~/Library/LaunchAgents/com.claude-ops.daemon.plist` + `…wacli-keepalive.plist` |
-| Linux / WSL2 | `systemd --user` unit + timer | `~/.config/systemd/user/claude-ops.service`, `claude-ops.timer`, `claude-ops-wacli-keepalive.service` |
+| macOS | `launchd` user agent | `~/Library/LaunchAgents/com.claude-ops.daemon.plist` + `…whatsapp-bridge-keepalive.plist` |
+| Linux / WSL2 | `systemd --user` unit + timer | `~/.config/systemd/user/claude-ops.service`, `claude-ops.timer`, `claude-ops-whatsapp-bridge-keepalive.service` |
| Windows | Task Scheduler | `ClaudeOpsDaemon` task running `bash.exe scripts/ops-daemon.sh --run-once` every 5 min (falls back to `pwsh.exe` wrapper if Git Bash isn't on PATH) |
**Cadence** is 5 minutes everywhere (`/SC MINUTE /MO 5` on Windows, `OnUnitActiveSec=5min` on systemd, throttled-loop on launchd).