MultiModel Dev OS

The Problem

You use Cursor for autocomplete, Claude Code for terminal ops, Gemini for deep audits. Every tool switch loses your context. Every .cursorrules / CLAUDE.md / .vscode/settings.json change drifts out of sync with the others. Prompts bloat, tokens waste, onboarding breaks.

The Fix: 30 Seconds

npx multimodel-dev-os@latest init

Your workspace now has a single source of truth that every AI coding tool reads automatically — no config duplication, no context loss, no vendor lock-in.

Already have a project? Onboard it safely:

npx multimodel-dev-os@latest onboard analyze

Key Features

| | Feature | What It Does | |:---|:---|:---| | 🔄 | Universal Adapter Sync | Write rules once → auto-syncs to .cursorrules, CLAUDE.md, .vscode/, .gemini/, and more | | ⚡ | Caveman Mode | Slash prompt token overhead by ~79% for tight API budgets | | 🧠 | Intelligence Engine | Hash-compressed memory, feedback learning, self-improvement proposals with HITL safety gates | | 📁 | Repo Onboarding | Analyze existing projects, recommend templates, and bootstrap configs without breaking anything | | 🔧 | Zero Dependencies | Pure Node.js CLI — no runtime, no build step, no package manager lock-in | | 🛡️ | 248+ Quality Gates | Built-in validate, doctor, and verify commands with strict structural assertions |

Supported Tools & Agents

| Tool / Agent | Adapter File | Status | |:---|:---|:---| | Codex (OpenAI) | adapters/codex/AGENTS.md | ✅ Full support | | Antigravity (Google DeepMind) | .gemini/settings.json | ✅ Full support | | Cursor | .cursorrules | ✅ Full support | | Claude Code (Anthropic) | CLAUDE.md | ✅ Full support | | Gemini (Google) | GEMINI.md | ✅ Full support | | VS Code (Copilot) | .vscode/settings.json | ✅ Full support | | Cline / Continue / Roo Code | Via adapter registry | 🔌 Adapter-ready | | Aider / Windsurf | Via adapter registry | 🔌 Adapter-ready | | MCP Tools (gcloud, Chrome DevTools) | Via tool registry | 🔌 Registry-ready |

Zero lock-in. Switch tools freely — your context, rules, and memory travel with you.

How It Works

┌─────────────────────────────────────────────────────────────┐
│  LAYER 1: Central Root Contracts (Single Source of Truth)   │
│  AGENTS.md  •  MEMORY.md  •  TASKS.md  •  RUNBOOK.md      │
└─────────────────────────┬───────────────────────────────────┘
                          │
┌─────────────────────────▼───────────────────────────────────┐
│  LAYER 2: Configuration & Intelligence (.ai/)                │
│  context/  agents/  skills/  prompts/  checks/  session/    │
└─────────────────────────┬───────────────────────────────────┘
                          │
┌─────────────────────────▼───────────────────────────────────┐
│  LAYER 3: Engine Workflows & Safety Gates                   │
│  onboard analyze  •  adapter sync  •  improve apply         │
└─────────────────────────┬───────────────────────────────────┘
                          │
┌─────────────────────────▼───────────────────────────────────┐
│  LAYER 4: Tool & IDE Adapters                               │
│  .cursorrules  •  CLAUDE.md  •  .vscode/  •  .gemini/      │
└─────────────────────────────────────────────────────────────┘

Essential Commands

# Initialize & Onboard
npx multimodel-dev-os@latest init --template nextjs-saas
npx multimodel-dev-os@latest onboard analyze

# Scan, Status & Memory
npx multimodel-dev-os@latest scan
npx multimodel-dev-os@latest status
npx multimodel-dev-os@latest memory build

# Sync IDE Adapters
npx multimodel-dev-os@latest adapter sync all --approved

# Run Workflows & Handoffs
npx multimodel-dev-os@latest workflow run repo-health
npx multimodel-dev-os@latest handoff build

📖 Full CLI Reference →

Why Not Just a Manual AGENTS.md?

| Capability | Manual Rules File | MultiModel Dev OS | |:---|:---|:---| | Tool Sync | Manual copy-paste across tools | ✅ Automated dynamic adapters | | Context Budgets | Bloats prompts, wastes tokens | ✅ Caveman Mode cuts ~79% overhead | | Standards | Easy to drift and corrupt | ✅ CLI validate + doctor + 214-assertion verify | | Templates | Start from scratch | ✅ 6 production-ready real-world templates | | Model Registry | Hardcoded model names | ✅ Dynamic capability-scored routing presets | | Self-Improvement | None | ✅ Feedback → Proposals → Apply with safety gates | | Onboarding | Manual setup every time | ✅ onboard analyze bootstraps existing repos |

What's New in v3.0

• 🛡️ Trusted Remote Registries & Governance — Manage and synchronize remote catalog indexes safely via registry command suite.
• 🎛️ Policy Engine — Configurable safety rules whitelisting destination directories, allowed extensions, and blocking sensitive file paths.
• 🔒 Zero Trust Integrity Chain — SHA256 checksum verification for all downloaded remote catalog assets.

Full Changelog →

Roadmap

| Version | Focus | Status | |:---|:---|:---| | v2.0.0 | Template Galaxy, Model Registry, Stable Protocol | ✅ Released | | v2.2.0 | Codebase Scanner & Hash-Compressed Memory Engine | ✅ Released | | v2.3.0 | Feedback Learning & Proposal Engine | ✅ Released | | v2.4.0 | Approved Proposal Application Engine | ✅ Released | | v2.5.0 | Repository Intelligence Command Center | ✅ Released | | v2.6.0 | Real-Repo Onboarding & Adapter Sync | ✅ Released | | v2.7.0 | Website, Demo & Distribution System | ✅ Released | | v2.8.0 / v2.8.1 | Interactive TUI Dashboard & Plugin Hooks | ✅ Released | | v2.9.0 | Local Workflow Marketplace & Plugin Catalog | ✅ Released | | v3.0.0 | Trusted Remote Catalog & Registry Governance Layer | ✅ Released | | v3.0.1 | Registry UX & Policy Safety Patch | ✅ Released | | v3.0.2 | Registry Sync Security Hotfix | ✅ Released | | v3.1.0 | Modular Source Layout + Formal Unit Tests | ✅ Released | | v3.2.0 | Stable Modular Build + Package Governance | ✅ Released | | v3.5.0 | Trusted Registry Signing + Provenance Foundation | ✅ Released |

Full Roadmap →

Documentation & Resources

| Resource | Link | |:---|:---| | 📖 Documentation Portal | rizvee.github.io/multimodel-dev-os | | 🐙 GitHub Repository | github.com/rizvee/multimodel-dev-os | | 📦 NPM Registry | npmjs.com/package/multimodel-dev-os | | 🤖 AI Discoverability | llms.txt | | 🚀 Quick Start | Quickstart Guide | | 🏗️ Architecture | Architecture Deep Dive | | ⚔️ Comparison | vs Alternatives | | 🛡️ Stable Protocol | Protocol Specification |

Contributing & Community

We welcome contributions! Propose new adapters, request templates, improve docs, or report issues.

• 📖 Contributing Guidelines
• 🐛 Report a Bug
• 💡 Request a Feature
• ⭐ Star us on GitHub — it helps others discover this project

License

MIT License. Copyright (c) 2026-present MultiModel Dev OS team.