omniwire 3.4.1 → 3.5.0

package/.omc/state/agent-replay-834b010e-b80d-4721-b297-777fbd0099c1.jsonl

@@ -0,0 +1,3 @@
+{"t":0,"agent":"a98481a","agent_type":"executor","event":"agent_stop","success":true}
+{"t":0,"agent":"a406c4b","agent_type":"executor","event":"agent_stop","success":true}
+{"t":0,"agent":"af2c636","agent_type":"executor","event":"agent_stop","success":true}

package/.omc/state/hud-state.json

@@ -1,6 +1,6 @@
 {
-  "timestamp": "2026-03-29T23:41:14.883Z",
+  "timestamp": "2026-03-30T01:25:32.860Z",
   "backgroundTasks": [],
-  "sessionStartTimestamp": "2026-03-29T23:21:14.012Z",
-  "sessionId": "8ef02123-7368-447d-82e3-ee14a27328b0"
+  "sessionStartTimestamp": "2026-03-30T01:09:39.072Z",
+  "sessionId": "834b010e-b80d-4721-b297-777fbd0099c1"
 }

package/.omc/state/hud-stdin-cache.json

@@ -1 +1 @@
-{"session_id":"8ef02123-7368-447d-82e3-ee14a27328b0","transcript_path":"C:\\Users\\Admin\\.claude\\projects\\C--Users-Admin\\8ef02123-7368-447d-82e3-ee14a27328b0.jsonl","cwd":"C:\\Users\\Admin\\omniwire","model":{"id":"claude-opus-4-6[1m]","display_name":"Opus 4.6 (1M context)"},"workspace":{"current_dir":"C:\\Users\\Admin\\omniwire","project_dir":"C:\\Users\\Admin","added_dirs":["C:/Users/Admin"]},"version":"2.1.87","output_style":{"name":"default"},"cost":{"total_cost_usd":20.34991630000001,"total_duration_ms":3367671,"total_api_duration_ms":2589826,"total_lines_added":563,"total_lines_removed":143},"context_window":{"total_input_tokens":180627,"total_output_tokens":109433,"context_window_size":1000000,"current_usage":{"input_tokens":1,"output_tokens":277,"cache_creation_input_tokens":374,"cache_read_input_tokens":197273},"used_percentage":20,"remaining_percentage":80},"exceeds_200k_tokens":false,"rate_limits":{"five_hour":{"used_percentage":3,"resets_at":1774846800},"seven_day":{"used_percentage":41,"resets_at":1775206800}}}
+{"session_id":"834b010e-b80d-4721-b297-777fbd0099c1","transcript_path":"C:\\Users\\Admin\\.claude\\projects\\C--Users-Admin\\834b010e-b80d-4721-b297-777fbd0099c1.jsonl","cwd":"C:\\Users\\Admin\\omniwire","model":{"id":"claude-opus-4-6[1m]","display_name":"Opus 4.6 (1M context)"},"workspace":{"current_dir":"C:\\Users\\Admin\\omniwire","project_dir":"C:\\Users\\Admin","added_dirs":["C:/Users/Admin"]},"version":"2.1.87","output_style":{"name":"default"},"cost":{"total_cost_usd":11.639808499999997,"total_duration_ms":1434832,"total_api_duration_ms":2352118,"total_lines_added":863,"total_lines_removed":209},"context_window":{"total_input_tokens":916983,"total_output_tokens":125069,"context_window_size":1000000,"current_usage":{"input_tokens":3,"output_tokens":108,"cache_creation_input_tokens":472,"cache_read_input_tokens":143821},"used_percentage":14,"remaining_percentage":86},"exceeds_200k_tokens":false,"rate_limits":{"five_hour":{"used_percentage":21,"resets_at":1774846800},"seven_day":{"used_percentage":44,"resets_at":1775206800}}}

package/.omc/state/last-tool-error.json

@@ -0,0 +1,7 @@
+{
+  "tool_name": "Bash",
+  "tool_input_preview": "{\"command\":\"git add README.md package.json clawhub-skill/SKILL.md integrations/openclaw/SKILL.md integrations/paperclip/SKILL.md integrations/paperclip/README.md integrations/oh-my-openagent/SKILL.md ...",
+  "error": "Exit code 1\nwarning: in the working copy of 'README.md', LF will be replaced by CRLF the next time Git touches it\nwarning: in the working copy of 'clawhub-skill/SKILL.md', LF will be replaced by CRLF the next time Git touches it\nwarning: in the working copy of 'package.json', LF will be replaced by CRLF the next time Git touches it\nThe following paths are ignored by one of your .gitignore files:\nintegrations\nhint: Use -f if you really want to add them.\nhint: Disable this message with \"git config...",
+  "timestamp": "2026-03-30T01:27:44.180Z",
+  "retry_count": 1
+}

package/.omc/state/subagent-tracking.json

@@ -0,0 +1,7 @@
+{
+  "agents": [],
+  "total_spawned": 0,
+  "total_completed": 0,
+  "total_failed": 0,
+  "last_updated": "2026-03-30T01:27:14.522Z"
+}

package/.omniwire-state/update-state.json

@@ -1,5 +1,5 @@
 {
-  "lastCheck": 1774829196137,
+  "lastCheck": 1774830769414,
   "lastVersion": "3.0.1",
   "autoUpdateEnabled": true,
   "source": "auto",

package/README.md

@@ -259,6 +259,72 @@ graph TB
 
 ---
 
+## Agent Setup Instructions
+
+### OpenClaw
+
+OmniWire is available as a [ClawhHub skill](https://clawhub.ai/voidchecksum/omniwire):
+
+```bash
+# Install via ClawhHub CLI
+clawhub install omniwire
+
+# Or manual: copy integrations/openclaw/SKILL.md to your OpenClaw skills directory
+cp integrations/openclaw/SKILL.md ~/.openclaw/skills/omniwire.md
+```
+
+CyberSync automatically ingests OpenClaw agents, skills, memory, and workspace into CyberBase PostgreSQL.
+
+### PaperClip
+
+Register OmniWire as a zero-cost infrastructure agent:
+
+```json
+{
+  "agents": [{
+    "name": "omniwire",
+    "type": "local-cli",
+    "command": "omniwire --stdio",
+    "skills": ["mesh-exec", "file-transfer", "service-control", "docker", "vpn", "scraping", "firewall"],
+    "budget": { "monthly_usd": 0 }
+  }]
+}
+```
+
+See `integrations/paperclip/` for the full adapter and skill definition.
+
+### Claude Code
+
+```json
+{
+  "mcpServers": {
+    "omniwire": {
+      "command": "omniwire",
+      "args": ["--stdio"]
+    }
+  }
+}
+```
+
+### OpenCode / Oh-My-OpenAgent
+
+```json
+{
+  "mcp": {
+    "omniwire": {
+      "type": "local",
+      "command": ["omniwire", "--stdio"]
+    }
+  }
+}
+```
+
+### Codex / Gemini
+
+CyberSync automatically syncs OmniWire config to Codex and Gemini environments.
+
+---
+
 ## Key Capabilities
 
 <table>
@@ -590,6 +656,139 @@ Create `~/.omniwire/mesh.json`:
 
 ---
 
+## Agentic Installation / Setup
+
+> For adding a new node to your OmniWire mesh — what to have ready, how to wire it in, and how to connect it to Claude Code.
+
+### Prerequisites
+
+| Requirement | Notes |
+|-------------|-------|
+| **Node.js >= 20** | `node -v` to verify |
+| **npm >= 9** | Comes with Node.js 20+ |
+| **WireGuard** | `wg` CLI + kernel module (Linux: `apt install wireguard`, macOS: Homebrew, Windows: GUI installer) |
+| **SSH key pair** | Ed25519 recommended — `ssh-keygen -t ed25519 -f ~/.ssh/id_omniwire` |
+| **SSH access to nodes** | Key deployed to `~/.ssh/authorized_keys` on every remote node |
+| **1Password CLI** | `op` v2+, signed in — required for `omniwire_secrets` and cookie sync to vault |
+| **PostgreSQL (optional)** | Required only for CyberSync / CyberBase persistence — Contabo hosts it at `10.10.0.1:5432` |
+
+### Install OmniWire
+
+```bash
+npm install -g omniwire
+omniwire --version   # verify
+```
+
+### Add a New Node
+
+**1. Generate WireGuard keypair on the new node:**
+```bash
+wg genkey | tee /etc/wireguard/node_private.key | wg pubkey > /etc/wireguard/node_pub.key
+cat /etc/wireguard/node_pub.key
+```
+
+**2. Assign it a mesh IP** (next available in `10.10.0.0/24`):
+
+| Node | Mesh IP | Role |
+|------|---------|------|
+| Contabo (hub) | `10.10.0.1` | storage, CyberBase |
+| Hostinger | `10.10.0.2` | compute |
+| Windows PC | `10.10.0.3` | local dev |
+| ThinkPad | `10.10.0.4` | local dev |
+| _new node_ | `10.10.0.N` | assign next |
+
+**3. Register the node with OmniMesh** (run from any node already in the mesh):
+```bash
+omniwire_omnimesh(action="add-peer",
+  id="newnode",
+  public_key="<pubkey from step 1>",
+  allowed_ips="10.10.0.N/32",
+  endpoint="<public IP or DNS>:51820"
+)
+```
+
+**4. Push updated peer list to all nodes:**
+```bash
+omniwire_omnimesh(action="sync-peers")
+```
+
+**5. Bring the interface up on the new node:**
+```bash
+wg-quick up wg0
+ping 10.10.0.1   # verify hub reachability
+```
+
+### Configure OmniWire on the New Node
+
+Add the node to `~/.omniwire/mesh.json` (create if absent):
+
+```json
+{
+  "nodes": [
+    { "id": "contabo",   "host": "10.10.0.1", "user": "root", "identityFile": "~/.ssh/id_omniwire", "role": "storage" },
+    { "id": "hostinger", "host": "10.10.0.2", "user": "root", "identityFile": "~/.ssh/id_omniwire", "role": "compute" },
+    { "id": "windows",   "host": "10.10.0.3", "user": "Admin", "identityFile": "~/.ssh/id_omniwire", "role": "local" },
+    { "id": "thinkpad",  "host": "10.10.0.4", "user": "user",  "identityFile": "~/.ssh/id_omniwire", "role": "local" }
+  ]
+}
+```
+
+Verify connectivity:
+```bash
+omniwire_mesh_status    # should show all nodes green
+omniwire_doctor         # checks SSH, disk, mem, WireGuard, CyberBase
+```
+
+### Connect Claude Code via MCP
+
+Add to `~/.claude/claude_desktop_config.json` (or your IDE's MCP config):
+
+```json
+{
+  "mcpServers": {
+    "omniwire": { "command": "omniwire", "args": ["--stdio"] }
+  }
+}
+```
+
+Restart Claude Code. Verify in a new session:
+```
+omniwire_mesh_status()   # 88 tools should be available
+```
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `OP_SERVICE_ACCOUNT_TOKEN` | For 1Password sync | Service account token from 1Password |
+| `OMNIWIRE_VAULT_ROOT` | Optional | Path to Obsidian vault root (default: CyberBase vault) |
+| `CYBERSYNC_DB_URL` | Optional | PostgreSQL DSN — defaults to `postgresql://cyberbase@10.10.0.1:5432/cyberbase` |
+| `OMNIWIRE_MESH_CONFIG` | Optional | Override mesh.json path |
+
+Set persistently on a node:
+```bash
+omniwire_env(action="set", key="OP_SERVICE_ACCOUNT_TOKEN", value="<token>", node="contabo", persist=true)
+```
+
+### CyberSync Auto-Distribution
+
+CyberSync pushes configs, secrets, and memories to all nodes automatically via PostgreSQL.
+
+```bash
+# Check what's tracked
+omniwire_coc(action="cybersync-status")
+
+# Force push current config to all nodes
+omniwire_coc(action="force-sync")
+
+# Diff local state vs database
+cybersync_diff()
+```
+
+On first run, CyberSync pulls node configs, 2FA seeds, and Claude memories from CyberBase — no manual copy-paste between machines.
+
+---
+
 ## Changelog
 
 <details>
@@ -687,6 +886,7 @@ omniwire/
 
 | Version | Date | Changes |
 |---------|------|---------|
+| **v3.5.0** | 2026-03-30 | Full OpenClaw + PaperClip integration. ClawhHub skill updated (v2.1.0→v3.5.0, 30→88 tools). Agent setup instructions for OpenClaw, PaperClip, Oh-My-OpenAgent. Updated all integration manifests. New: `integrations/paperclip/SKILL.md`, `integrations/paperclip/README.md`. |
 | **v3.4.1** | 2026-03-30 | Cross-OS: `omniwire_scrape` install works on Linux (systemd), macOS (launchd), Windows, Docker (nohup). Auto-upgrades deps + browsers. Python/pip path detection. |
 | **v3.4.0** | 2026-03-30 | Rewrite: `omniwire_scrape` — OmniMesh-routed Scrapling with auto-install, VPN routing, adaptive selectors, XPath, bulk sessions. install/status actions. Full README audit (88 tools). |
 | **v3.3.1** | 2026-03-30 | New: `omniwire_scrape` tool — Scrapling-powered web scraping (static/browser/stealth modes, Cloudflare bypass, TLS spoofing). |

package/clawhub-skill/SKILL.md

@@ -1,57 +1,62 @@
 ---
 name: omniwire
-version: 2.1.0
-description: "Control your entire server mesh from chat. Execute commands, transfer files, manage Docker, sync configs, and monitor all your nodes — VPS, Raspberry Pi, laptop, desktop — through one unified interface. 30 MCP tools. Works on any architecture (x64, ARM, Apple Silicon). SSH2 with compression, encrypted config sync, 1Password secrets backend. Just say what you need and your agent runs it across every machine."
-tags: [infrastructure, mesh, ssh, devops, servers, vps, docker, remote, mcp, file-transfer, monitoring, config-sync, secrets, multi-node, raspberry-pi, arm]
+version: 3.5.0
+description: "Infrastructure layer for AI agent swarms — 88 MCP tools for mesh control, A2A protocol, OmniMesh VPN, CyberSync, web scraping, firewall management, browser automation, and more. ~80ms execution."
+tags: [infrastructure, mesh, ssh, devops, servers, docker, remote, mcp, vpn, wireguard, a2a, cybersync, firewall, scraping, browser, security, arm, monitoring, latest]
 author: VoidChecksum
 homepage: https://github.com/VoidChecksum/omniwire
+license: GPL-3.0-only
 metadata:
   openclaw:
     emoji: "🌐"
+    primaryEnv: ""
+    skillKey: omniwire
     requires:
       bins: ["node", "ssh"]
       env: []
+    install:
+      - kind: node
+        package: omniwire@latest
+        bins: ["omniwire", "ow"]
     stateDirs: ["~/.omniwire"]
-    persistence: "This skill uses OmniWire (npm package) to manage SSH connections to your mesh nodes. Config lives in ~/.omniwire/mesh.json. Encrypted secrets in ~/.omniwire/secret.key. No data leaves your network — all operations run over your own SSH connections."
+    persistence: "OmniWire uses SSH2 to control mesh nodes. Config in ~/.omniwire/mesh.json. Encrypted secrets in ~/.omniwire/secret.key. CyberSync stores knowledge in PostgreSQL. No data leaves your network."
 ---
 
-# OmniWire — Mesh Control for OpenClaw
+# OmniWire v3.5.0 — Mesh Control for AI Agent Swarms
 
-> **Your entire infrastructure, controlled from chat.**
+> **88 MCP tools. 12 categories. Every machine, one agent, zero friction.**
 
-Tell your agent to run commands on any server, transfer files between nodes, manage Docker containers, check system health, sync configurations, and manage secrets — across every machine you own. One skill. Any architecture.
+OmniWire is the infrastructure layer for AI agent swarms. It connects your entire mesh (VPS, laptops, Raspberry Pis, Docker hosts) into a single controllable surface with 88 tools spanning execution, A2A protocol, OmniMesh VPN, CyberSync, web scraping, firewall management, CDP browser automation, and more.
 
 ```
-You: check disk usage on all my servers
+You: check disk and container status on all servers
 
-Agent: [runs across all nodes simultaneously]
+Agent: [omniwire_broadcast + omniwire_docker — parallel across all nodes]
 
-  [server1] (142ms)
-  /dev/sda1    1.2T  178G   16%  /
-
-  [server2] (198ms)
-  /dev/sda1    50G   31G    61%  /
-
-  [rpi] (215ms)
-  /dev/mmcblk0  32G   6.4G  20%  /
+  contabo  | 10.0.0.1 | ONLINE | 78ms  | disk=16% | containers: 12 running
+  kali     | 10.0.0.2 | ONLINE | 91ms  | disk=34% | containers: 4 running
+  rpi      | 10.0.0.3 | ONLINE | 112ms | disk=20% | containers: 2 running
 ```
 
 ---
 
 ## What It Does
 
-OmniWire connects all your machines (VPS, laptops, Raspberry Pis, desktops) into one mesh that your OpenClaw agent can control. It provides **30 tools** across 8 categories:
-
-| Category | What your agent can do |
-|----------|----------------------|
-| **Execute** | Run any command on any node or all nodes at once |
-| **Files** | Read, write, list, search files on any machine |
-| **Transfer** | Move files between nodes (auto-selects fastest method) |
-| **Docker** | Manage containers, images, logs across nodes |
-| **Monitor** | CPU, memory, disk, network, processes — live |
-| **Services** | Start/stop/restart systemd services remotely |
-| **Secrets** | Store, retrieve, sync secrets (1Password or file-based) |
-| **Sync** | Keep configs synchronized across all machines |
+| Category | Tools | What your agent can do |
+|----------|-------|----------------------|
+| **Execution** | 6 | Run commands, scripts, pipelines, background jobs on any node |
+| **Agentic / A2A** | 13 | Agent tasks, messaging, blackboard, workflows, semaphores, registries |
+| **Files** | 6 | Read, write, list, find, transfer, deploy files across nodes |
+| **Monitoring** | 4 | Mesh health, live metrics, benchmarks, node info |
+| **System / DevOps** | 14 | Processes, disks, packages, services, Docker, kernel, cron, git, logs |
+| **Network / VPN** | 7 | VPN switching, port forwarding, browser, shell, streams, proxy, scraping |
+| **Security** | 6 | Firewall, certs, audit, 2FA/TOTP, cookies, user management |
+| **CyberSync** | 9 | Bi-directional config sync for 6 AI tools + knowledge/memory |
+| **Knowledge** | 2 | Store and search unified knowledge base (pgvector) |
+| **OmniMesh** | 3 | WireGuard mesh manager, expose services, gateway routing |
+| **Events** | 1 | Webhook + WebSocket + SSE event bus |
+| **CDP Browser** | 1 | 18 browser actions via persistent Docker Chrome |
+| **Utilities** | 10+ | Alerts, aliases, backups, snippets, DNS, diagnostics, scheduling |
 
 ---
 
@@ -61,199 +66,396 @@ OmniWire connects all your machines (VPS, laptops, Raspberry Pis, desktops) into
 
 > **AGENT: Run this via exec. User just clicks Approve.**
 
-```
-npm install -g omniwire
+```bash
+npm install -g omniwire@latest
 ```
 
-Works on: Linux (x64, ARM, armv7l), macOS (Intel + Apple Silicon), Windows, Raspberry Pi.
+Works on: Linux (x64, ARM64, ARMv7), macOS (Intel + Apple Silicon), Windows (x64).
 
 ### Step 2: Configure Your Mesh
 
 Create the mesh config. Ask the user for their server details:
 
 > **AGENT: Ask the user:**
-> "What servers do you want to control? I need for each one:
-> - A name (e.g., `server1`, `rpi`, `laptop`)
+> "What servers do you want to control? For each one I need:
+> - A name (e.g., `contabo`, `kali`, `rpi`)
 > - IP address or hostname
 > - SSH user (usually `root`)
-> - SSH key filename in ~/.ssh/ (e.g., `id_ed25519`)"
+> - SSH key filename in ~/.ssh/ (e.g., `id_ed25519`)
+> - Role: `storage`, `compute`, `gpu+browser`, or leave blank"
 
-Then create the config via exec:
+Then create the config:
 
-```
+```bash
 mkdir -p ~/.omniwire
 cat > ~/.omniwire/mesh.json << 'EOF'
 {
   "nodes": [
     {
-      "id": "SERVER_NAME",
-      "host": "SERVER_IP",
+      "id": "contabo",
+      "host": "10.0.0.1",
       "user": "root",
       "identityFile": "id_ed25519",
       "role": "storage",
-      "tags": ["vps"]
+      "tags": ["vps", "docker"]
+    },
+    {
+      "id": "kali",
+      "host": "10.0.0.2",
+      "user": "root",
+      "identityFile": "id_ed25519",
+      "role": "compute",
+      "tags": ["kali", "pentest"]
     }
-  ]
+  ],
+  "cyberbase": {
+    "host": "10.10.0.1",
+    "port": 5432,
+    "database": "cyberbase",
+    "user": "cyberbase"
+  }
 }
 EOF
 ```
 
-**Roles:** `storage` (file server/DB), `compute` (heavy processing), `gpu+browser` (GPU/display), or omit for general.
-
 ### Step 3: Verify
 
-```
-echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}' | omniwire --stdio --no-sync 2>/dev/null | head -1
+```bash
+echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}' \
+  | omniwire --stdio --no-sync 2>/dev/null | head -1
 ```
 
-Should show `omniwire v2.1.0`. Done.
+Should respond with `omniwire v3.5.0`. Done.
 
----
+**Transport options:**
 
-## How to Use — Just Talk
+| Transport | Command | Port |
+|-----------|---------|------|
+| stdio (MCP default) | `omniwire --stdio` | — |
+| SSE (HTTP streaming) | `omniwire --sse` | 3200 |
+| REST (HTTP JSON) | `omniwire --rest` | 3201 |
+| Events (WebSocket) | `omniwire --events` | 3202 |
 
-Once set up, just tell your agent what you need. It uses OmniWire's MCP tools automatically.
+---
 
-### Run commands anywhere
+## Usage Examples
+
+### Execute commands anywhere
 
 ```
-You: restart nginx on server1
+You: restart nginx on contabo
 
-Agent: [exec on server1] systemctl restart nginx
-  ✓ nginx restarted
+Agent: [omniwire_exec node=contabo command="systemctl restart nginx"]
+  OK — nginx restarted (0ms)
 
-You: show me what's using the most CPU on all servers
+You: run uptime on every server
 
-Agent: [broadcast to all nodes]
-  [server1] node (45% CPU) — omnibus-hub
-  [server2] python3 (23% CPU) — training job
-  [rpi] chromium (12% CPU) — dashboard
+Agent: [omniwire_broadcast command="uptime"]
+  contabo  | up 42 days, 3:21
+  kali     | up 7 days, 11:04
+  rpi      | up 2 days, 0:15
 ```
 
-### Transfer files between machines
+### Transfer files between nodes
 
 ```
-You: copy /var/log/app.log from server1 to server2
+You: copy the pentest report from kali to contabo
 
-Agent: Transferred 4.2MB via netcat+gzip in 180ms (23.3 MB/s)
+Agent: [omniwire_transfer_file src_node=kali dest_node=contabo src=/root/report.pdf dest=/var/reports/]
+  Transferred 2.4MB — LZ4 compressed — 83ms
 ```
 
-OmniWire auto-selects the fastest transfer mode:
-- **SFTP** for files under 10MB (zero overhead)
-- **netcat+gzip** for 10MB-1GB (compressed TCP stream)
+Transfer modes (auto-selected):
+- **SFTP** for files under 10MB
+- **netcat + LZ4** for 10MB–1GB
 - **aria2c** for files over 1GB (16 parallel connections)
 
-### Manage Docker
+### Docker management
 
 ```
-You: what containers are running on server1?
+You: what containers are running on contabo?
 
-Agent: [server1] docker ps
-  12 running · 3 stopped
-  kali-htb  redamon-agent  omnibus-hub  neo4j  postgres ...
+Agent: [omniwire_docker node=contabo action=ps]
+  12 running — neo4j, postgres, omnibus-hub, kali-htb, omniwire-events...
 
-You: restart the neo4j container
+You: pull and start the latest omniwire-events image
 
-Agent: [server1] docker restart neo4j
-  ✓ neo4j restarted (healthy)
+Agent: [omniwire_container node=contabo action=pull image=omniwire-events:latest]
+  Pulled. Starting...
+  ✓ omniwire-events running (healthy)
 ```
 
-### Monitor everything
+### Monitor mesh health
 
 ```
-You: how are my servers doing?
+You: how are all my servers doing?
 
-Agent: [mesh status — all nodes parallel]
+Agent: [omniwire_mesh_status]
 
-  server1 (storage)    | 10.0.0.1 | ONLINE | 142ms | load=2.3 | mem=26% | disk=16%
-  server2 (compute)    | 10.0.0.2 | ONLINE | 198ms | load=1.4 | mem=27% | disk=61%
-  rpi     (gpu)        | 10.0.0.3 | ONLINE | 215ms | load=0.7 | mem=21% | disk=20%
+  contabo  | 10.0.0.1 | ONLINE | 78ms  | load=1.2 | mem=31% | disk=16%
+  kali     | 10.0.0.2 | ONLINE | 91ms  | load=0.4 | mem=19% | disk=34%
+  rpi      | 10.0.0.3 | ONLINE | 112ms | load=0.7 | mem=22% | disk=20%
 ```
 
-### Manage secrets across nodes
+### VPN switching
+
+```
+You: switch to Mullvad on the kali node
 
+Agent: [omniwire_vpn node=kali action=connect provider=mullvad country=nl]
+  Connected — Netherlands exit — mesh routes preserved
+  New IP: 185.65.134.x
 ```
-You: store my API key across all servers
 
-Agent: What's the key name and value?
+Supported providers: Mullvad, OpenVPN, WireGuard, Tailscale. OmniMesh routes are protected during VPN switches.
 
-You: OPENAI_KEY = sk-proj-abc123...
+### Web scraping with Cloudflare bypass
 
-Agent: [omniwire_secrets set + sync]
-  server1: OK
-  server2: OK
-  rpi: OK
-  ✓ Synced OPENAI_KEY to 3 nodes
 ```
+You: scrape the pricing table from example.com
 
-Supports **1Password** backend — configure in `~/.omniwire/secrets.json`:
-```json
-{"backend": "onepassword", "vault": "Infrastructure"}
+Agent: [omniwire_scrape node=contabo url=https://example.com/pricing selector=".pricing-table"]
+  Scraped 4.2KB — Scrapling engine — Cloudflare bypassed
+  [returns structured data]
 ```
 
-### Sync configurations
+### A2A agent messaging
 
-CyberSync keeps your AI tool configs (Claude Code, OpenCode, OpenClaw, Codex, Gemini) synchronized across all machines:
+```
+You: send a task to the pentest agent on kali
+
+Agent: [omniwire_agent_task node=kali agent_id=pentest-agent task={type:"scan", target:"192.168.1.0/24"}]
+  Task queued — ID: task_abc123
 
+Agent: [omniwire_blackboard action=watch key=task_abc123/result]
+  Result ready: {hosts: 12, open_ports: [...]}
 ```
-You: sync my claude code settings to all servers
 
-Agent: [cybersync_sync_now]
-  Reconciled: pushed=3, pulled=0, conflicts=0
-  ✓ All nodes up to date
+### COC — Unified CyberBase + Obsidian + Canvas sync
+
 ```
+You: COC save — OmniWire v3.5.0 deployed with 88 tools
 
-Sensitive files (settings.json, credentials, memory) are encrypted at rest with **XChaCha20-Poly1305**.
+Agent: [omniwire_coc action=save note="OmniWire v3.5.0 deployed with 88 tools"]
+  Saved to CyberBase (knowledge table)
+  Mirrored to Obsidian vault: CyberBase/omniwire-v350.md
+  Canvas node updated: CyberBase MindMap.canvas
+  ✓ All 3 sync targets confirmed
+```
 
 ---
 
-## All 30 Tools
+## Full Tool Reference
+
+<details>
+<summary><strong>Execution (6 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `omniwire_exec` | Execute a command on a specific node. Args: `node`, `command`, `timeout`, `background` |
+| `omniwire_run` | Run a named script or predefined task. Args: `node`, `script`, `args` |
+| `omniwire_batch` | Execute multiple commands across multiple nodes in one call. Args: `commands[]` |
+| `omniwire_broadcast` | Execute command on ALL nodes simultaneously. Args: `command`, `tags` (filter by tag) |
+| `omniwire_pipeline` | Chain commands where output of one feeds into next. Args: `node`, `steps[]` |
+| `omniwire_bg` | Background task manager — dispatch, poll, get result. Args: `action`, `task_id` |
+
+</details>
+
+<details>
+<summary><strong>Agentic / A2A Protocol (13 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `omniwire_store` | Key-value store for agents. Actions: get, set, delete, list. Args: `key`, `value`, `ttl` |
+| `omniwire_watch` | Watch a key for changes (long-poll). Args: `key`, `timeout` |
+| `omniwire_healthcheck` | Check agent health status across nodes. Args: `agent_id`, `node` |
+| `omniwire_agent_task` | Dispatch a structured task to a named agent. Args: `node`, `agent_id`, `task` |
+| `omniwire_a2a_message` | Send an A2A protocol message between agents. Args: `to`, `from`, `message`, `reply_to` |
+| `omniwire_semaphore` | Distributed semaphore for agent coordination. Actions: acquire, release. Args: `name`, `count` |
+| `omniwire_event` | Emit a named event into the event bus. Args: `event`, `data`, `targets[]` |
+| `omniwire_workflow` | Execute a multi-step workflow definition. Args: `workflow_id`, `input` |
+| `omniwire_agent_registry` | Register/discover agents by capability. Actions: register, lookup, list |
+| `omniwire_blackboard` | Shared blackboard for agent state. Actions: read, write, watch, clear |
+| `omniwire_task_queue` | Distributed task queue. Actions: push, pop, peek, size |
+| `omniwire_capability` | Declare/query agent capabilities. Args: `agent_id`, `capabilities[]` |
+| `omniwire_coc` | COC — unified CyberBase + Obsidian + Canvas sync. Actions: save, read, search, update |
+
+</details>
+
+<details>
+<summary><strong>Files (6 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `omniwire_read_file` | Read file from any node. Args: `node`, `path`, `encoding`, `lines` |
+| `omniwire_write_file` | Write file to any node. Args: `node`, `path`, `content`, `mode` |
+| `omniwire_list_files` | List directory on any node. Args: `node`, `path`, `recursive`, `filter` |
+| `omniwire_find_files` | Search files across nodes by name/content/pattern. Args: `node`, `query`, `path` |
+| `omniwire_transfer_file` | Copy files between nodes (auto-selects SFTP/LZ4/aria2c). Args: `src_node`, `dest_node`, `src`, `dest` |
+| `omniwire_deploy` | Push files or directories to multiple nodes simultaneously. Args: `src`, `nodes[]`, `dest` |
+
+</details>
+
+<details>
+<summary><strong>Monitoring (4 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `omniwire_mesh_status` | Health check all nodes — latency, load, memory, disk. Cached 5s. |
+| `omniwire_node_info` | Detailed info for one node — OS, CPU, uptime, IPs. Args: `node` |
+| `omniwire_live_monitor` | Live system metrics snapshot. Args: `node`, `interval`, `metrics[]` |
+| `omniwire_benchmark` | Benchmark node performance — CPU, disk, network. Args: `node`, `type` |
+
+</details>
+
+<details>
+<summary><strong>System / DevOps (14 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `omniwire_process_list` | List and filter processes. Args: `node`, `filter`, `sort` |
+| `omniwire_disk_usage` | Disk usage — all mounts or specific path. Args: `node`, `path` |
+| `omniwire_install_package` | Install packages via apt/npm/pip/brew. Args: `node`, `package`, `manager` |
+| `omniwire_service_control` | systemd start/stop/restart/status/enable. Args: `node`, `service`, `action` |
+| `omniwire_docker` | Docker commands (ps, logs, exec, stats, images). Args: `node`, `action`, `container` |
+| `omniwire_container` | Container lifecycle — pull, run, stop, rm, inspect. Args: `node`, `action`, `image` |
+| `omniwire_kernel` | dmesg, sysctl, modprobe, strace, perf. Args: `node`, `action`, `args` |
+| `omniwire_cron` | Manage cron jobs — list, add, remove. Args: `node`, `action`, `schedule`, `command` |
+| `omniwire_env` | Read/write environment variables. Args: `node`, `action`, `key`, `value` |
+| `omniwire_network` | Network info — interfaces, routes, connections, iptables. Args: `node`, `action` |
+| `omniwire_git` | Git operations on remote nodes. Args: `node`, `repo`, `action`, `args` |
+| `omniwire_syslog` | Read system logs. Args: `node`, `service`, `lines`, `since` |
+| `omniwire_log_aggregate` | Aggregate logs from multiple nodes. Args: `nodes[]`, `service`, `query` |
+| `omniwire_metrics` | Push/pull metrics (Prometheus-compatible). Args: `node`, `action`, `metrics` |
+
+</details>
+
+<details>
+<summary><strong>Network / VPN (7 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `omniwire_vpn` | VPN management — Mullvad, OpenVPN, WireGuard, Tailscale. Args: `node`, `action`, `provider`, `country` |
+| `omniwire_port_forward` | SSH tunnel / port forwarding. Args: `node`, `local_port`, `remote_host`, `remote_port` |
+| `omniwire_open_browser` | Open URL on GPU/display node. Args: `node`, `url` |
+| `omniwire_shell` | Persistent shell session (state preserved). Args: `node`, `session_id`, `command` |
+| `omniwire_stream` | Real-time streaming output from long-running commands. Args: `node`, `command` |
+| `omniwire_proxy` | HTTP/SOCKS proxy management. Args: `node`, `action`, `port`, `type` |
+| `omniwire_scrape` | Scrapling-powered web scraping with Cloudflare bypass. Args: `node`, `url`, `selector`, `format` |
+
+</details>
+
+<details>
+<summary><strong>Security (6 tools)</strong></summary>
 
-Your agent has access to these automatically via MCP:
+| Tool | Description |
+|------|-------------|
+| `omniwire_firewall` | iptables / ufw / nftables management. Args: `node`, `action`, `rule` |
+| `omniwire_cert` | TLS certificate management (Let's Encrypt, self-signed). Args: `node`, `domain`, `action` |
+| `omniwire_audit` | Security audit — open ports, SUID files, cron jobs, users. Args: `node`, `checks[]` |
+| `omniwire_2fa` | TOTP manager — generate, add, delete codes. CyberBase + 1Password persistence. Args: `action`, `service` |
+| `omniwire_cookies` | Browser cookie export/import (JSON, Header String, Netscape). Args: `node`, `action`, `browser` |
+| `omniwire_user` | User account management — create, delete, sudo, SSH keys. Args: `node`, `action`, `username` |
+
+</details>
+
+<details>
+<summary><strong>CyberSync (9 tools)</strong></summary>
+
+CyberSync provides bi-directional config sync for 6 AI tools: **Claude Code, OpenCode, OpenClaw, Codex, Gemini, PaperClip**. All sensitive files encrypted with XChaCha20-Poly1305 at rest.
 
-### Core (22 tools)
 | Tool | Description |
 |------|-------------|
-| `omniwire_exec` | Execute command on a specific node |
-| `omniwire_broadcast` | Execute on all nodes simultaneously |
-| `omniwire_mesh_status` | Health + resources for all nodes |
-| `omniwire_node_info` | Detailed info for one node |
-| `omniwire_read_file` | Read file from any node |
-| `omniwire_write_file` | Write file to any node |
-| `omniwire_transfer_file` | Copy files between nodes (auto mode) |
-| `omniwire_list_files` | List directory on any node |
-| `omniwire_find_files` | Search files across all nodes |
-| `omniwire_tail_log` | Read last N lines of a log |
-| `omniwire_process_list` | List processes (filterable) |
-| `omniwire_disk_usage` | Disk usage across nodes |
-| `omniwire_install_package` | Install via apt/npm/pip |
-| `omniwire_service_control` | systemd start/stop/restart/status |
-| `omniwire_docker` | Docker commands on any node |
-| `omniwire_open_browser` | Open URL on GUI node |
-| `omniwire_port_forward` | SSH tunnel management |
-| `omniwire_deploy` | Push files to multiple nodes |
-| `omniwire_kernel` | dmesg, sysctl, modprobe, strace, perf |
-| `omniwire_shell` | Persistent shell sessions (preserves state) |
-| `omniwire_stream` | Real-time streaming output |
-| `omniwire_live_monitor` | Live system metrics snapshot |
-
-### CyberSync (8 tools)
+| `omniwire_sync` | Sync a specific file or directory across nodes. Args: `path`, `nodes[]`, `direction` |
+| `omniwire_sync_rules` | Manage sync rules (include/exclude patterns). Args: `action`, `rule` |
+| `omniwire_sync_hooks` | Pre/post sync hooks. Args: `action`, `hook_script` |
+| `omniwire_sync_memory` | Sync Claude/agent memory to CyberBase. Args: `action`, `node` |
+| `omniwire_sync_agents` | Sync agent definitions across nodes. Args: `action`, `nodes[]` |
+| `cybersync_status` | Sync status — item counts, heartbeats, last sync time per tool |
+| `cybersync_sync_now` | Force immediate reconciliation across all nodes |
+| `cybersync_diff` | Show what's out of sync before committing |
+| `cybersync_history` | Sync event log — what changed, when, which node |
+
+</details>
+
+<details>
+<summary><strong>Knowledge (2 tools)</strong></summary>
+
 | Tool | Description |
 |------|-------------|
-| `cybersync_status` | Sync status, item counts, heartbeats |
-| `cybersync_sync_now` | Force immediate reconciliation |
-| `cybersync_diff` | Show what needs syncing |
-| `cybersync_history` | Sync event log |
-| `cybersync_search_knowledge` | Search unified knowledge base |
-| `cybersync_get_memory` | Query Claude memory from DB |
-| `cybersync_manifest` | Show tracked files per tool |
-| `cybersync_force_push` | Push specific file to all nodes |
-
-### Secrets + Update
+| `omniwire_knowledge` | Store knowledge entries in CyberBase with vector embedding. Args: `action`, `key`, `content`, `tags` |
+| `omniwire_search_knowledge` | Semantic search over knowledge base (pgvector). Args: `query`, `limit`, `tags` |
+
+</details>
+
+<details>
+<summary><strong>OmniMesh (3 tools)</strong></summary>
+
+OmniMesh is OmniWire's built-in WireGuard mesh manager. It provisions, rotates keys, and manages peer routing automatically.
+
 | Tool | Description |
 |------|-------------|
-| `omniwire_secrets` | Get/set/delete/list/sync secrets |
-| `omniwire_update` | Check for updates + self-update |
+| `omniwire_omnimesh` | Mesh lifecycle — init, add-node, remove-node, rotate-keys, status. Args: `action`, `node` |
+| `omniwire_mesh_expose` | Expose a local service to the mesh via WireGuard. Args: `node`, `service`, `port`, `mesh_port` |
+| `omniwire_mesh_gateway` | Configure a node as a mesh gateway (egress/ingress). Args: `node`, `action`, `routes[]` |
+
+</details>
+
+<details>
+<summary><strong>Events (1 tool)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `omniwire_events` | Event bus — subscribe, publish, list. Supports Webhook callbacks, WebSocket push (port 3202), and SSE streaming. Args: `action`, `event`, `handler_url` |
+
+</details>
+
+<details>
+<summary><strong>CDP Browser (1 tool)</strong></summary>
+
+`omniwire_cdp` provides 18 browser actions via a persistent Docker Chrome instance on any node. Sessions persist between calls. Cookies auto-exported in JSON + Header String + Netscape format.
+
+| Action | Description |
+|--------|-------------|
+| `navigate` | Navigate to URL |
+| `screenshot` | Capture page screenshot |
+| `click` | Click element by selector |
+| `type` | Type text into input |
+| `scroll` | Scroll page |
+| `evaluate` | Execute JavaScript |
+| `get_html` | Get page HTML |
+| `get_text` | Get visible text |
+| `wait_for` | Wait for selector/navigation |
+| `fill_form` | Fill multiple form fields |
+| `select` | Select dropdown option |
+| `hover` | Hover element |
+| `upload` | Upload file to input |
+| `download` | Download file |
+| `cookies_get` | Export cookies |
+| `cookies_set` | Import cookies |
+| `session_save` | Persist session state |
+| `session_load` | Restore session state |
+
+</details>
+
+<details>
+<summary><strong>Utilities (10+ tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `omniwire_alert` | Send alert via Telegram/webhook/email. Args: `message`, `channel`, `priority` |
+| `omniwire_alias` | Manage command aliases for nodes. Args: `action`, `name`, `command` |
+| `omniwire_backup` | Backup files/DBs to remote storage. Args: `node`, `path`, `dest`, `compress` |
+| `omniwire_clipboard` | Read/write clipboard on GUI node. Args: `node`, `action`, `content` |
+| `omniwire_snippet` | Store and retrieve command snippets. Args: `action`, `name`, `content` |
+| `omniwire_tail_log` | Tail last N lines of a log file. Args: `node`, `path`, `lines` |
+| `omniwire_trace` | Distributed trace for debugging command chains. Args: `trace_id`, `action` |
+| `omniwire_update` | Check for OmniWire updates + self-update. Args: `action` |
+| `omniwire_schedule` | Schedule tasks (cron-style). Args: `action`, `schedule`, `task` |
+| `omniwire_dns` | DNS lookup and management. Args: `node`, `query`, `type` |
+| `omniwire_doctor` | Diagnose OmniWire setup issues. Args: `checks[]` |
+
+</details>
 
 ---
 
@@ -261,13 +463,16 @@ Your agent has access to these automatically via MCP:
 
 | Operation | Speed |
 |-----------|-------|
-| Command execution | ~120ms per node |
-| File read (< 1MB) | ~80ms (SFTP) |
-| File transfer (10MB) | ~200ms (gzip netcat) |
-| Config sync (push all) | ~200ms (parallel) |
-| Mesh status check | ~150ms (cached 5s) |
+| Command execution | ~80ms per node |
+| File read (< 1MB) | ~60ms (SFTP) |
+| File transfer (10MB) | ~150ms (LZ4 netcat) |
+| Mesh status check | ~100ms (cached 5s) |
+| COC sync (all 3 targets) | ~200ms (parallel) |
+| Web scrape (no JS) | ~300ms |
+| Web scrape (Cloudflare) | ~800ms |
+| CDP browser action | ~120ms |
 
-All connections use **SSH2 with zlib compression** over your existing network (WireGuard, Tailscale, direct SSH — anything works).
+Encryption: **AES-128-GCM** for transport, **XChaCha20-Poly1305** for at-rest sync items. Compression: **LZ4** for transfers.
 
 ---
 
@@ -275,24 +480,30 @@ All connections use **SSH2 with zlib compression** over your existing network (W
 
 | Platform | Architecture | Status |
 |----------|-------------|--------|
-| Linux | x64 | ✅ |
-| Linux | arm64 (RPi 4/5, AWS Graviton) | ✅ |
-| Linux | armv7l (RPi 3, older ARM) | ✅ |
-| macOS | Intel (x64) | ✅ |
-| macOS | Apple Silicon (arm64) | ✅ |
-| Windows | x64 | ✅ |
+| Linux | x64 | Supported |
+| Linux | arm64 (RPi 4/5, AWS Graviton) | Supported |
+| Linux | armv7l (RPi 3, older ARM) | Supported |
+| macOS | Intel (x64) | Supported |
+| macOS | Apple Silicon (arm64) | Supported |
+| Windows | x64 | Supported |
+
+No native compilation. Pure JavaScript + SSH2. `npm install -g omniwire` works everywhere Node.js 18+ runs.
 
-No native compilation required — pure JavaScript + SSH2. `npm install -g omniwire` works everywhere Node.js runs.
+**Transports:** stdio (MCP standard), SSE port 3200, REST port 3201, Events/WebSocket port 3202.
 
 ---
 
 ## Security
 
-- **Transport**: SSH2 with zlib compression (encrypted by default)
-- **At-rest encryption**: XChaCha20-Poly1305 for sensitive sync items
-- **Secrets**: 1Password, file-based, or env var backends
-- **No external services**: Everything runs on your own infrastructure
-- **Key management**: Master key in `~/.omniwire/secret.key` (generated locally, never transmitted)
+| Layer | Implementation |
+|-------|---------------|
+| Transport | SSH2 with zlib compression |
+| At-rest (sync items) | XChaCha20-Poly1305 |
+| Transfer compression | LZ4 |
+| Secrets backend | 1Password, file-based, or env vars |
+| Network | All traffic over your own infrastructure (WireGuard, Tailscale, direct SSH) |
+| Key management | Master key in `~/.omniwire/secret.key` — generated locally, never transmitted |
+| Mesh auth | Per-node WireGuard keypairs, auto-rotated by OmniMesh |
 
 ---
 
@@ -300,55 +511,122 @@ No native compilation required — pure JavaScript + SSH2. `npm install -g omniw
 
 ### When to use OmniWire tools
 
-Use OmniWire tools when the user:
-- Mentions servers, VPS, nodes, infrastructure, or "my machines"
-- Wants to run commands remotely ("run X on server1", "check Y on all servers")
-- Needs to transfer, read, or write files on remote machines
-- Asks about Docker containers on remote nodes
-- Wants to monitor system resources across machines
-- Needs to manage secrets or sync configurations
-- Mentions "deploy", "restart service", "install package" on remote targets
+Use OmniWire when the user:
+- Mentions servers, VPS, nodes, mesh, or "my machines"
+- Wants commands run remotely or on all servers
+- Needs files read, written, or transferred between nodes
+- Asks about Docker, services, processes, or system health on remote nodes
+- Wants to switch VPN, manage firewall rules, or handle certs
+- Mentions "scrape", "browser", "CDP", or web automation on a remote node
+- Wants to sync configs, save memory, or COC/save something
+- Uses agent-to-agent workflows (A2A, blackboard, task queues)
+- Needs TOTP codes, cookies, or security audit
+- Mentions "COC", "Save to CyberBase", "Obsidian", or canvas sync
 
 ### How to pick the right tool
 
-- **Single node command** → `omniwire_exec`
-- **All nodes at once** → `omniwire_broadcast`
-- **Read a remote file** → `omniwire_read_file`
-- **Copy between nodes** → `omniwire_transfer_file`
-- **Docker anything** → `omniwire_docker`
-- **Check health** → `omniwire_mesh_status`
-- **Store a secret** → `omniwire_secrets` (action: set)
-- **Sync configs** → `cybersync_sync_now`
-
-### Default node selection
+| Intent | Tool |
+|--------|------|
+| Single node command | `omniwire_exec` |
+| All nodes at once | `omniwire_broadcast` |
+| Read remote file | `omniwire_read_file` |
+| Copy between nodes | `omniwire_transfer_file` |
+| Docker anything | `omniwire_docker` |
+| Container lifecycle | `omniwire_container` |
+| Mesh health check | `omniwire_mesh_status` |
+| VPN switch | `omniwire_vpn` |
+| Firewall rule | `omniwire_firewall` |
+| Web scrape | `omniwire_scrape` |
+| Browser automation | `omniwire_cdp` |
+| Send agent task | `omniwire_agent_task` |
+| Shared state | `omniwire_blackboard` |
+| Event bus | `omniwire_event` or `omniwire_events` |
+| COC save/sync | `omniwire_coc` |
+| Semantic search | `omniwire_search_knowledge` |
+| Background job | `omniwire_bg` |
+| Sync AI configs | `cybersync_sync_now` |
+
+### Node selection defaults
 
 If the user doesn't specify a node:
-- File storage operations → use the node with `role: "storage"`
-- Docker operations → use the node with `role: "storage"` (usually the Docker host)
-- Browser operations → use the node with `role: "gpu+browser"`
-- Heavy compute → use `role: "compute"`
-- If unclear, ask: "Which server should I run this on?"
+- File storage, databases, Docker → node with `role: "storage"`
+- Security/pentest tools → node with tag `"kali"` or `"pentest"`
+- GPU / display / browser → node with `role: "gpu+browser"`
+- Heavy compute → node with `role: "compute"`
+- Background task dispatch → `omniwire_bg` with any available node
+- If ambiguous, ask: "Which server should I run this on?"
+
+### Background mode
+
+All 88 tools support `background: true`. Use it for:
+- Any operation expected to take > 5 seconds
+- Builds, installs, deploys, large transfers
+- Scraping and CDP sessions
+- Long-running pipelines
+
+```
+omniwire_exec(node="contabo", command="apt upgrade -y", background=true)
+→ returns task_id immediately
+→ poll with omniwire_bg(action="poll", task_id="...")
+→ get result with omniwire_bg(action="result", task_id="...")
+```
 
 ### Error handling
 
-- If a node is offline, tell the user and offer to try another node
-- If a command fails, show the error and suggest fixes
-- If transfer fails, retry with a different mode
+- If a node is offline, report it and offer alternatives
+- If exec fails, show stderr and suggest fixes
+- If transfer fails, retry with a different mode (SFTP → LZ4 → aria2c)
+- If VPN connects but mesh breaks, restore mesh routes automatically (built-in)
+- For persistent shell failures, use `omniwire_shell` with a new `session_id`
 
 ---
 
-## Links
+## OpenClaw + PaperClip Integration
 
-- **GitHub**: https://github.com/VoidChecksum/omniwire
-- **NPM**: https://www.npmjs.com/package/omniwire
-- **Issues**: https://github.com/VoidChecksum/omniwire/issues
+OmniWire is the primary infrastructure backend for OpenClaw agents and PaperClip workflows.
+
+### OpenClaw
+
+OpenClaw agents use OmniWire for all remote operations. The skill is auto-loaded when OpenClaw detects `omniwire` in the installed MCP servers. Agents can:
+- Execute tasks across the mesh without user intervention
+- Use the A2A protocol to coordinate multi-agent workflows
+- Persist state via the blackboard and knowledge base
+- Dispatch background jobs and collect results asynchronously
+
+### PaperClip
+
+PaperClip workflows integrate with OmniWire via CyberSync. Any workflow that produces knowledge, memory, or config changes can route through `omniwire_coc` for unified persistence across CyberBase, Obsidian vault, and Canvas.
+
+**COC workflow from PaperClip:**
+
+```
+1. Workflow completes → calls omniwire_coc(action="save", ...)
+2. Saved to CyberBase knowledge table with pgvector embedding
+3. Mirrored to Obsidian vault as .md file
+4. Canvas node created/updated in CyberBase MindMap.canvas
+5. All nodes confirmed in one response
+```
+
+### Sync coverage — CyberSync 6 AI tools
+
+| Tool | Synced Config |
+|------|-------------|
+| Claude Code | `~/.claude/settings.json`, CLAUDE.md, memory, agents/ |
+| OpenCode | `~/.opencode/config.json`, rules/ |
+| OpenClaw | `~/.openclaw/config.json`, skills/, agents/ |
+| Codex | `~/.codex/config.json` |
+| Gemini | `~/.gemini/settings.json` |
+| PaperClip | `~/.paperclip/config.json`, workflows/ |
 
 ---
 
-## License
+## Links
 
-MIT — Use freely, modify, distribute.
+- **GitHub**: https://github.com/VoidChecksum/omniwire
+- **NPM**: https://www.npmjs.com/package/omniwire
+- **Issues**: https://github.com/VoidChecksum/omniwire/issues
+- **License**: GPL-3.0-only
 
 ---
 
-*OmniWire — Every machine, one agent, zero friction.*
+*OmniWire v3.5.0 — 88 tools. Every machine. One agent.*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omniwire",
-  "version": "3.4.1",
+  "version": "3.5.0",
   "description": "Infrastructure layer for AI agent swarms — 88 MCP tools · A2A · OmniMesh VPN · Scrapling scraper · COC sync · nftables firewall · CDP browser · 2FA TOTP · ~80ms",
   "license": "GPL-3.0-only",
   "type": "module",