omniwire 3.4.0 → 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":17.91894630000001,"total_duration_ms":3140566,"total_api_duration_ms":2378114,"total_lines_added":474,"total_lines_removed":126},"context_window":{"total_input_tokens":180562,"total_output_tokens":100001,"context_window_size":1000000,"current_usage":{"input_tokens":1,"output_tokens":359,"cache_creation_input_tokens":356,"cache_read_input_tokens":184970},"used_percentage":19,"remaining_percentage":81},"exceeds_200k_tokens":false,"rate_limits":{"five_hour":{"used_percentage":2,"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,7 +886,9 @@ omniwire/
 
 | Version | Date | Changes |
 |---------|------|---------|
-| **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 everywhere). |
+| **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). |
 | **v3.3.0** | 2026-03-30 | New: `omniwire_coc` tool — unified CyberBase + Obsidian + Canvas sync. Auto-creates vault + canvas. `mirror-db` exports entire DB as .md. Configurable vault via `OMNIWIRE_VAULT_ROOT` env. |
 | **v3.2.2** | 2026-03-30 | Fix: sync GitHub/npm metadata — badge, description, mermaid diagram all reflect 86 tools |