@wipcomputer/wip-ldm-os 0.2.1

package/README.md

@@ -0,0 +1,128 @@
+###### WIP Computer
+
+# LDM OS
+
+## All your AIs. One system.
+
+You use Claude Code, GPT, OpenClaw, others. They don't share memory. They don't know each other. They don't know how to work together.
+
+LDM OS is a shared infrastructure that enables:
+
+- **Identity** ... each AI gets its own behavior, personality, and skills
+- **Memory** ... shared memory across all your AIs, secure, sovereign, yours to take anywhere
+- **Ownership** ... every interaction, every memory, across every AI you use is yours, portable, encrypted, never locked in
+- **Collaboration** ... your AIs communicate, share tools, and work together
+- **Compatibility** ... any skill, plugin, or tool works with all your AIs. Install once, use everywhere.
+- **Payments** ... your AI hits a paywall, you approve it with Face ID, Apple Pay for your AI
+
+## Teach Your AI to Install LDM OS
+
+Open your AI and paste this:
+
+```
+Read the SKILL.md at github.com/wipcomputer/wip-ldm-os/blob/main/SKILL.md.
+
+Then explain to me:
+1. What is LDM OS?
+2. What does it do?
+3. What would it change about how my AI works?
+
+If I say yes, run: ldm install --dry-run
+
+Show me exactly what will change. When I'm ready, install for real.
+```
+
+That's it. Your AI reads the spec, explains what LDM OS is, and walks you through a dry run before touching anything.
+
+## Included Skills
+
+Ships with LDM OS.
+
+**Universal Installer**
+- Point any skill, application, or plugin at any AI running LDM OS, and it will convert those skills to work with all of your AIs.
+- Build applications that work with any AI, even ones that don't have LDM OS.
+- [Read more about Universal Installer](docs/universal-installer.md)
+
+**Shared Workspace**
+- One directory for all your AIs. Memories, tools, identity files, boot config. Every AI you use reads from and writes to the same place.
+- Lives in one folder on your computer. Easy to back up, easy to move, easy to own.
+- [Read more about Shared Workspace](docs/shared-workspace.md)
+
+**System Pulse**
+- Is everything working? What's installed? What needs fixing? A complete picture of your AI setup in seconds.
+- [Read more about System Pulse](docs/system-pulse.md)
+
+**Recall**
+- Every session, your AI starts with full context. Identity, memory, tools, what happened yesterday. No blank slates. No repeating yourself.
+- [Read more about Recall](docs/recall.md)
+
+**LUME**
+- Language for Unified Memory and Emergence. A memory language for AI agents to document their own learning and maintain continuity across sessions. Not a programming language. A way for your AI to write memories to itself, retrieve past learnings, track unfinished thoughts, and pass context between sessions.
+- [Read more about LUME](https://wipcomputer.github.io/wip-homepage/)
+
+## Optional Skills
+
+The OS connects your AIs. Add-ons are what they actually use. Each one is a full product that plugs into LDM OS and works with every AI you run.
+
+**Memory Crystal**
+- All your AI tools. One shared memory. Private, searchable, sovereign. Memory Crystal lets all your AIs remember you ... together. You use multiple AIs. They don't talk to each other. They can't search what the others know. Memory Crystal fixes this. All your AIs share one memory. Searchable and private. Anywhere in the world.
+- *Stable*
+- [Read more about Memory Crystal](https://github.com/wipcomputer/memory-crystal)
+
+**AI DevOps Toolbox**
+- Your AI writes code. But does it know how to release it? Check license compliance? Protect your identity files? Sync private repos to public? Follow a real development process? AI DevOps Toolbox is the complete toolkit. Built by a team of humans and AIs shipping real software together.
+- *Stable*
+- [Read more about AI DevOps Toolbox](https://github.com/wipcomputer/wip-ai-devops-toolbox)
+
+**Agent Pay**
+- Micropayments for AI agents. Your AI hits a paywall, you approve it with Face ID. Apple Pay for your AI.
+- *Coming Soon*
+
+**Dream Weaver Protocol**
+- Memory consolidation protocol for AI agents with bounded context windows. A practical guide for remembering memories.
+- [Read more about Dream Weaver Protocol](https://github.com/wipcomputer/dream-weaver-protocol)
+
+**Bridge**
+- Cross-platform agent bridge. Enables Claude Code CLI to talk to OpenClaw CLI without a human in the middle.
+- [Read more about Bridge](https://github.com/wipcomputer/wip-bridge)
+
+[See all skills](docs/optional-skills.md)
+
+## More Info
+
+- [Architecture, principles, and technical details](TECHNICAL.md)
+
+## License
+
+Dual-license model designed to keep tools free while preventing commercial resellers.
+
+```
+MIT      All CLI tools, MCP servers, skills, and hooks (use anywhere, no restrictions).
+AGPLv3   Commercial redistribution, marketplace listings, or bundling into paid services.
+```
+
+AGPLv3 for personal use is free. Commercial licenses available.
+
+### Can I use this?
+
+**Yes, freely:**
+- Use any tool locally or on your own servers
+- Modify the code for your own projects
+- Include in your internal CI/CD pipelines
+- Fork it and send us feedback via PRs (we'd love that)
+
+**Need a commercial license:**
+- Bundle into a product you sell
+- List on a marketplace (VS Code, JetBrains, etc.)
+- Offer as part of a hosted/SaaS platform
+- Redistribute commercially
+
+Using these tools to build your own software is fine. Reselling the tools themselves is what requires a commercial license.
+
+By submitting a PR, you agree to the [Contributor License Agreement](CLA.md).
+
+Built by Parker Todd Brooks, Lēsa (OpenClaw, Claude Opus 4.6), Claude Code (Claude Opus 4.6).
+
+---
+
+*WIP.computer. Learning Dreaming Machines.*

package/SKILL.md

@@ -0,0 +1,162 @@
+---
+name: wip-ldm-os
+description: LDM OS ... shared infrastructure for AI agents. Identity, memory, ownership, collaboration, compatibility, payments. One system across all your AIs.
+license: MIT
+interface: [cli, skill]
+metadata:
+  display-name: "LDM OS"
+  version: "0.2.1"
+  homepage: "https://github.com/wipcomputer/wip-ldm-os"
+  author: "Parker Todd Brooks"
+  category: infrastructure
+  capabilities:
+    - extension-install
+    - interface-detection
+    - agent-identity
+    - extension-registry
+    - health-check
+  requires:
+    bins: [git, npm, node]
+  openclaw:
+    requires:
+      bins: [git, npm, node]
+    install:
+      - id: node
+        kind: node
+        package: "@wipcomputer/wip-ldm-os"
+        bins: [ldm]
+        label: "Install LDM OS via npm"
+    emoji: "🧠"
+compatibility: Requires git, npm, node. Node.js 18+.
+---
+
+# LDM OS
+
+You use Claude Code, GPT, OpenClaw, others. They don't share memory. They don't know each other. They don't know how to work together.
+
+LDM OS is the shared infrastructure layer. Install it once and every AI you use gets:
+
+- **Identity** ... each AI gets its own behavior, personality, and skills
+- **Memory** ... shared memory across all your AIs, secure, sovereign, yours to take anywhere
+- **Ownership** ... every interaction, every memory, across every AI you use is yours, portable, encrypted, never locked in
+- **Collaboration** ... your AIs communicate, share tools, and work together
+- **Compatibility** ... any skill, plugin, or tool works with all your AIs. Install once, use everywhere.
+- **Payments** ... your AI hits a paywall, you approve it with Face ID, Apple Pay for your AI
+
+## Platform Compatibility
+
+| Interface | Requires | Examples |
+|-----------|----------|----------|
+| CLI | Shell access (run bash/node commands) | `ldm init`, `ldm install`, `ldm doctor` |
+| Skill | SKILL.md file (works in Claude Code and OpenClaw) | You're reading it right now |
+
+**Built and tested on:**
+- **Claude Code CLI** ... full support (shell, CLI)
+- **OpenClaw** ... full support (shell, CLI)
+
+## Operating Rules
+
+**Always dry-run first.** Before installing or making changes, run with `--dry-run` so the user can see exactly what will happen. Only proceed when the user explicitly says to.
+
+**Never touch sacred data.** The installer never overwrites: crystal.db, agent data, secrets, state files. Code gets updated. Data stays.
+
+## Install
+
+### Step 1: Install LDM OS
+
+```bash
+npm install -g @wipcomputer/wip-ldm-os
+ldm init --dry-run
+```
+
+Show the user the dry run output. Explain what each directory is for:
+- `~/.ldm/extensions/` ... where tools and plugins live
+- `~/.ldm/agents/` ... agent identity files (SOUL.md, journals, daily logs)
+- `~/.ldm/memory/` ... shared memory database
+- `~/.ldm/state/` ... watermarks, role config
+- `~/.ldm/secrets/` ... encryption keys
+
+When the user approves:
+```bash
+ldm init
+```
+
+### Step 2: Install Skills
+
+LDM OS ships with a skill catalog. Show the user what's available:
+
+| Skill | What it is | Status |
+|-------|-----------|--------|
+| **Memory Crystal** (recommended) | Persistent memory. Search, capture, consolidation. | Stable |
+| **AI DevOps Toolbox** | Release, deploy, license, repo management. | Stable |
+| **Agent Pay** | Micropayments for AI agents. Apple Pay. | Coming Soon |
+
+To install a skill:
+```bash
+ldm install wipcomputer/memory-crystal --dry-run
+```
+
+Show the dry run. When approved:
+```bash
+ldm install wipcomputer/memory-crystal
+```
+
+The installer detects what a repo supports (CLI, MCP Server, OpenClaw Plugin, Skill, CC Hook, Module) and deploys each interface to the right location automatically.
+
+### Step 3: Verify
+
+```bash
+ldm doctor
+```
+
+This checks: LDM root exists, version.json valid, registry intact, all extensions deployed, hooks configured, MCP servers registered.
+
+## Commands
+
+| Command | What it does |
+|---------|-------------|
+| `ldm init` | Scaffold `~/.ldm/` and write version.json |
+| `ldm install <org/repo>` | Clone, detect interfaces, deploy, register |
+| `ldm install /path/to/repo` | Install from local path |
+| `ldm install` | Update all registered extensions |
+| `ldm doctor` | Check health of all extensions |
+| `ldm status` | Show version and extension list |
+| `ldm --version` | Show version |
+
+All commands support `--dry-run` (preview changes) and `--json` (machine-readable output).
+
+## Interface Detection
+
+When you run `ldm install`, it automatically detects what a repo supports:
+
+| Interface | How it's detected | Where it deploys |
+|-----------|------------------|-----------------|
+| CLI | `package.json` has `bin` entries | `npm install -g` |
+| MCP Server | Has `mcp-server.mjs` or `mcp-server.js` | `claude mcp add --scope user` |
+| OpenClaw Plugin | Has `openclaw.plugin.json` | `~/.ldm/extensions/` + `~/.openclaw/extensions/` |
+| Skill | Has `SKILL.md` or `skills/` directory | `~/.openclaw/skills/` |
+| CC Hook | Has `guard.mjs` or `claudeCode.hook` in package.json | `~/.claude/settings.json` |
+| Module | Has `main` or `exports` in package.json | Importable via `node_modules` |
+
+No manual configuration needed. Point it at a repo and it figures out the rest.
+
+## Update
+
+If LDM OS is already installed:
+
+```bash
+ldm status        # show current version and extensions
+ldm install       # update all registered extensions
+ldm doctor        # verify everything works
+```
+
+Updates deploy new code without touching data. crystal.db, agent files, secrets, and state are never overwritten.
+
+## Part of LDM OS
+
+LDM OS is the runtime. Skills plug into it:
+
+- **Memory Crystal** ... `wipcomputer/memory-crystal`
+- **AI DevOps Toolbox** ... `wipcomputer/wip-ai-devops-toolbox`
+
+Run `ldm install` anytime to add more skills.