@wipcomputer/wip-ldm-os 0.4.37 → 0.4.38

package/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 interface: [cli, skill]
 metadata:
   display-name: "LDM OS"
-  version: "0.4.37"
+  version: "0.4.38"
   homepage: "https://github.com/wipcomputer/wip-ldm-os"
   author: "Parker Todd Brooks"
   category: infrastructure

package/bin/ldm.js

@@ -363,6 +363,23 @@ async function cmdInit() {
     }
   }
 
+  // Deploy backup + restore scripts (#119)
+  const backupSrc = join(__dirname, '..', 'scripts', 'ldm-backup.sh');
+  const backupDest = join(LDM_ROOT, 'bin', 'ldm-backup.sh');
+  if (existsSync(backupSrc)) {
+    mkdirSync(join(LDM_ROOT, 'bin'), { recursive: true });
+    cpSync(backupSrc, backupDest);
+    chmodSync(backupDest, 0o755);
+    console.log(`  + ldm-backup.sh deployed to ~/.ldm/bin/`);
+  }
+  const restoreSrc = join(__dirname, '..', 'scripts', 'ldm-restore.sh');
+  const restoreDest = join(LDM_ROOT, 'bin', 'ldm-restore.sh');
+  if (existsSync(restoreSrc)) {
+    cpSync(restoreSrc, restoreDest);
+    chmodSync(restoreDest, 0o755);
+    console.log(`  + ldm-restore.sh deployed to ~/.ldm/bin/`);
+  }
+
   console.log('');
   console.log(`  LDM OS v${PKG_VERSION} initialized at ${LDM_ROOT}`);
   console.log('');

package/docs/bridge/README.md

@@ -4,7 +4,7 @@
 
 ## Your AIs talk to each other.
 
-Cross-platform agent communication. Bridge (MCP), Agent Client Protocol (ACP-Client, Zed Industries), and Agent Communication Protocol (ACP-Comm, IBM/Linux Foundation). Three protocols, one system. Claude Code sends a message, OpenClaw responds. OpenClaw sends a task, Claude Code executes it.
+Cross-platform agent communication. Claude Code talks to Claude Code. Claude Code talks to OpenClaw. OpenClaw talks back. Bridge (MCP), Agent Client Protocol (ACP-Client, Zed Industries), and Agent Communication Protocol (ACP-Comm, IBM/Linux Foundation). Three protocols, one system.
 
 ## Three Protocols, One System
 
@@ -16,7 +16,7 @@ LDM OS uses three complementary protocols. Bridge is one of them.
 | **Protocol** | MCP (JSON-RPC over stdio) | JSON-RPC over stdio + WebSocket | REST/HTTP |
 | **Built by** | WIP Computer | Zed Industries | IBM / Linux Foundation |
 | **In LDM OS** | Core (v0.3.0+) | Available via OpenClaw | Planned (Cloud Relay) |
-| **What it connects** | Claude Code <-> OpenClaw agents | IDEs (Zed, VS Code) <-> agents | Cloud agents <-> each other |
+| **What it connects** | CC <-> CC + CC <-> OpenClaw agents | IDEs (Zed, VS Code) <-> agents | Cloud agents <-> each other |
 | **Memory access** | Yes (search + read across agents) | No | No |
 | **Skill sharing** | Yes (OpenClaw skills as MCP tools) | No | No |
 | **Where it runs** | Localhost only | Localhost (stdio) + remote (WebSocket) | Cloud (HTTP endpoints) |
@@ -37,13 +37,23 @@ All three are Apache 2.0 compatible with our MIT + AGPL license. See [ACP docs](
 | `oc_skills_list` | List all OpenClaw skills. |
 | `oc_skill_*` | Run any OpenClaw skill with scripts. |
 
+## Session Discovery
+
+Multiple Claude Code sessions can discover each other via the Agent Register. On boot, Recall registers each session at `~/.ldm/sessions/`. Any session can list all running sessions with `ldm sessions`.
+
+The registry tracks agent ID (cc-mini, cc-air), PID, working directory, and start time. Stale sessions (dead PIDs) are auto-cleaned on read. See `lib/sessions.mjs`.
+
 ## Message Flow
 
+**CC <-> OpenClaw:**
 ```
 CC  --lesa_send_message-->  OpenClaw Gateway (localhost:18789)  -->  Lesa
 CC  <--lesa_check_inbox---  HTTP Inbox (localhost:18790)        <--  Lesa
 ```
 
+**CC <-> CC:**
+Multiple Claude Code sessions communicate via the file-based message bus and session registry at `~/.ldm/sessions/`. Each session registers on boot and can discover peers. No broker daemon required.
+
 Both directions are live. Everything is localhost. No cloud.
 
 ## Part of LDM OS

package/docs/bridge/TECHNICAL.md

@@ -3,7 +3,9 @@
 ## Architecture
 
 ```
-Claude Code CLI
+Claude Code CLI (cc-mini, cc-air, or any CC session)
+  |
+  |-- On boot --> registerSession() --> ~/.ldm/sessions/{name}.json (session discovery)
   |
   |-- MCP stdio --> wip-bridge MCP server (single process)
   |                   |
@@ -22,6 +24,13 @@ Claude Code CLI
   |                   |-- lesa_memory_search --> filesystem (workspace/*.md)
   |                   |
   |                   |-- oc_skill_* --> exec scripts in ~/.openclaw/extensions/*/skills/
+
+CC <-> CC (multi-session):
+  CC session A --> registerSession() --> ~/.ldm/sessions/a.json
+  CC session B --> registerSession() --> ~/.ldm/sessions/b.json
+  CC session A --> listSessions()    --> discovers session B (agent ID, PID, cwd)
+  CC session B --> listSessions()    --> discovers session A
+  Communication via file-based message bus at ~/.ldm/sessions/
 ```
 
 ## MCP Tools
@@ -65,6 +74,22 @@ Bridge starts a localhost-only HTTP server on port 18790:
 
 Messages are held in memory. `lesa_check_inbox` drains the queue.
 
+## Session Discovery
+
+On boot, Recall registers the session via `registerSession()` from `lib/sessions.mjs`. Each session writes a JSON file to `~/.ldm/sessions/{name}.json` containing:
+
+- `name` — session identifier
+- `agentId` — agent identity (e.g. `cc-mini`, `cc-air`)
+- `pid` — process ID (used for liveness checks)
+- `startTime` — ISO timestamp
+- `cwd` — working directory
+
+`listSessions()` reads all session files, validates PID liveness (signal 0 probe), and auto-cleans stale entries. Filter by `agentId` to find specific agents. `sessionCount()` returns a quick count of live sessions.
+
+CLI: `ldm sessions` lists all active sessions.
+
+This enables CC-to-CC awareness without a broker daemon. Any session can discover any other session on the machine.
+
 ## Key Files
 
 | File | What |
@@ -72,6 +97,7 @@ Messages are held in memory. `lesa_check_inbox` drains the queue.
 | `src/bridge/core.ts` | Pure logic: config, messaging, search, skills |
 | `src/bridge/mcp-server.ts` | MCP server: tool registration, inbox HTTP server |
 | `src/bridge/cli.ts` | CLI wrapper (`lesa` command) |
+| `lib/sessions.mjs` | Session registration, discovery, PID liveness |
 | `dist/bridge/` | Compiled output (ships with npm package) |
 
 ## Node Communication (Future)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-ldm-os",
-  "version": "0.4.37",
+  "version": "0.4.38",
   "type": "module",
   "description": "LDM OS: identity, memory, and sovereignty infrastructure for AI agents",
   "engines": {