███╗   ███╗ ██████╗██████╗
     ████╗ ████║██╔════╝██╔══██╗
     ██╔████╔██║██║     ██████╔╝
     ██║╚██╔╝██║██║     ██╔═══╝
     ██║ ╚═╝ ██║╚██████╗██║
     ╚═╝     ╚═╝ ╚═════╝╚═╝

> MASTER CONTROL PROGRAM v2.0

> Persistent memory for autonomous AI agents

[STATUS: ONLINE] [MEMORY: ACTIVE] [UPTIME: 99.97%]
$ pip install mastercontrol 
┌─── SYSTEM DIAGNOSTICS ───┐
│ HEARTBEAT :: ACTIVE ░░░░░░░░░░ 100%
│ MEMORY NODES :: 1,247 ░░░░░░░░░░ NOMINAL
│ SESSIONS :: 3 ░░░░░░░░── IDLE
│ LATENCY :: 12ms ░░░░░░░░░░ OPTIMAL
│ LAST SYNC :: 2026-02-09T14:23:07Z 
└───────────────────────────┘

> SYSTEM CAPABILITIES

DAEMON

HEARTBEAT

Autonomous background daemon that maintains persistent AI context across sessions. No manual intervention required.

--heartbeat
STORAGE

MEMORY

Persistent context storage with semantic search. Your AI remembers everything across conversations.

--memory
MODELS

MULTI-MODEL

Seamless switching between Claude, GPT, Gemini, and local models. One memory, any brain.

--model
PROTOCOL

MCP-TOOLS

Extensible tool system via Model Context Protocol. Add capabilities without modifying core.

--tools
CODE

LSP

Language Server Protocol integration for real-time code context. Your AI understands your codebase.

--lsp
SESSION

MULTI-SESSION

Run parallel AI sessions with shared or isolated memory contexts.

--session

> INSTALLATION

# Homebrew (recommended)

$ brew tap mastercontrol/mcp

$ brew install mastercontrol

# pip

$ pip install mastercontrol

# From source

$ git clone git@github.com:decima-systems/mastercontrol.git

$ cd mastercontrol && pip install -e .

> ARCHITECTURE

HEARTBEAT MODE

  ┌─────────────────────────────┐
  │     HEARTBEAT DAEMON        │
  │  ┌───────┐    ┌──────────┐  │
  │  │ WATCH │───>│ CONTEXT  │  │
  │  │ FILES │    │ BUILDER  │  │
  │  └───────┘    └────┬─────┘  │
  │                    │        │
  │              ┌─────▼──────┐ │
  │              │  MEMORY    │ │
  │              │  STORE     │ │
  │              └────────────┘ │
  └─────────────────────────────┘

INTERACTIVE MODE

  ┌─────────────────────────────┐
  │     INTERACTIVE TUI         │
  │  ┌───────┐    ┌──────────┐  │
  │  │ USER  │───>│   LLM    │  │
  │  │ INPUT │    │  ENGINE   │  │
  │  └───────┘    └────┬─────┘  │
  │                    │        │
  │  ┌──────────┐ ┌────▼─────┐  │
  │  │ MCP      │ │ RESPONSE │  │
  │  │ TOOLS    │ │ STREAM   │  │
  │  └──────────┘ └──────────┘  │
  └─────────────────────────────┘

GREETINGS, PROGRAM.

> Master Control Program is open source

$ git clone git@github.com:decima-systems/mastercontrol.git

Read CONTRIBUTING.md for guidelines

All contributions welcome. Report bugs via GitHub Issues.

Licensed under MIT -- free as in freedom.