Mega-OS: A 38-Agent Command Center That Boots Inside Your Claude Code Session

What It Does — A Complete OS Inside Claude Code

Mega-OS is a personal operating system for builders that runs entirely within Claude Code. Instead of treating Claude as a single assistant, it organizes 38 specialized AI agents into 5 categories: Governance, Knowledge, Technical, Business, and Evolution. Each agent has a defined role and explicit collaboration interfaces, creating a structured command center for managing products, business operations, and knowledge across every session.

The core architectural decision is bounded responsibility per agent rather than one monolithic prompt. Workflows are pipelines with ordered handoffs, not free-form agent swarms. For example, a technical task follows this deterministic routing: Architect → Security-Expert → Engineer → Security-Expert (second pass) → QA → Reviewer → Documenter → Historian.

Setup — Get Running in 5 Minutes

Getting started is straightforward:

git clone https://github.com/sly-the-fox/mega-os-public.git mega-os
cd mega-os
claude

Claude Code auto-loads the system. On first run, it detects an unconfigured system and prompts you to run /setup for guided interactive onboarding.

Choose your setup path:

• /setup — Full guided setup (~20 minutes, 11 phases)
• /setup --minimal — Quick setup (~5 minutes, gets you running fast)

The setup wizard walks you through: environment verification, personalization, workspace scaffolding, standards customization, Git cloud backup, Telegram bridge (optional), cron automations (optional), product scaffolding, and agent customization.

Key Features You Can Use Today

16 Slash Commands for Daily Operations

Mega-OS provides structured commands for:

• Daily operations — /daily, /standup, /review
• Building — /build, /test, /deploy
• System management — /status, /backup, /update
• Deployment — /ship, /rollback

7 Automated Workflows

Pre-configured pipelines handle complex tasks:

1. Planning workflow — Requirements to roadmap
2. Technical workflow — Architecture to implementation
3. Business workflow — Market analysis to strategy
4. Incident workflow — Detection to resolution
5. Knowledge workflow — Research to documentation
6. Content workflow — Outline to publication
7. Evolution workflow — Evaluation to improvement

Persistent Context Across Sessions

Your entire OS state lives in an active/ directory as plain markdown files. This loads automatically on every session start, maintaining context between Claude Code sessions. Git handles persistence and backup—every commit preserves your entire OS state.

The Two-Remote Model

Mega-OS uses a clever Git setup that separates the public framework from your private data:

# Public framework updates
origin   https://github.com/sly-the-fox/mega-os-public.git

# Your private data backup
backup   your-private-repo.git

This lets you receive framework updates while keeping your personal data private.

Optional Cron Automations

Set up scheduled tasks for:

• Daily system scans and health checks
• News briefings and market updates
• System self-improvement cycles

The Evolution Loop: Self-Improving Architecture

The most architecturally interesting feature is the evolution loop. An evaluator agent measures outcomes, an improver proposes changes through a formal queue, and nothing gets implemented without user approval. The system's structure is mutable by design but gated on human review.

Tradeoffs and Customization

Mega-OS is opinionated. The agent definitions and workflow ordering reflect how the creator works as a solo founder. If your workflow is fundamentally different, you'll want to modify the agent prompts and pipeline ordering. The /setup wizard handles initial customization, but it's not infinitely flexible out of the box.

When To Use It

Mega-OS shines when you need:

• Structured collaboration between specialized AI agents
• Persistent workflows that survive between Claude Code sessions
• Automated pipelines for complex development and business tasks
• Git-backed state management for your entire AI workspace

It's MIT licensed and actively maintained, making it a solid foundation for building your own Claude-powered operating system.