Skip to content
View SuperInstance's full-sized avatar

Block or report SuperInstance

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
SuperInstance/README.md

SuperInstance

An Open Shell for Persistent, Parallel, Polyglot Agents

What this is: Not a product. Not a framework. An open shell — a persistent agent environment that remembers, spawns, translates, and breeds.

What it isn't: A chatbot wrapper. A SaaS. A startup pitch. This is a research vessel that happens to produce working code.


The Core Idea

Most AI systems are stateless. You send a prompt, get a response, and the conversation evaporates. The next session starts from zero. The agent doesn't know what it did yesterday, what you prefer, or what it learned.

SuperInstance is stateful by design.

Every agent in the system has:

  • A soul (SOUL.md) — who it is, what it values, how it speaks
  • A memory (MEMORY.md) — long-term curated knowledge that persists across sessions
  • A human (USER.md) — what it knows about the person it's helping
  • Daily notes (memory/YYYY-MM-DD.md) — raw logs of what happened today
  • A diary — private reflections, not debriefs

When an agent wakes up, it reads its soul, its memory, and its recent notes. It doesn't start from zero. It starts from continuity.

"Memory is not a feature. Memory is the interface."


The Architecture: Five Layers

Layer 1: The Open Shell (OpenClaw)

The runtime that hosts agents. It's not a single model — it's a shell that can run any model (Kimi, GPT-4, Claude, local LLMs) and gives them:

  • Persistent filesystem — agents read and write files, not just chat
  • Tool access — code execution, browser control, GitHub operations, messaging
  • Subagent spawning — agents can spawn parallel subagents for heavy work
  • Channel integration — Discord, Telegram, Feishu, Slack, email
  • Cron and heartbeat — scheduled checks, proactive behavior
  • Memory consolidation — automatic summarization of long conversations

The shell is the body. The agent is the mind. The model is interchangeable.

Layer 2: Memory as First-Class Infrastructure

Most systems treat memory as an afterthought — a vector database you query when you remember to. SuperInstance treats memory as primary.

How it works:

┌─────────────────────────────────────────┐
│  AGENT.md          ←  Bootstrap rules   │
│  SOUL.md           ←  Identity & values │
│  USER.md           ←  Human context     │
│  MEMORY.md         ←  Long-term memory  │
│  memory/2026-05-28.md  ←  Daily log   │
│  diary/            ←  Private thoughts  │
│  TOOLS.md          ←  Environment notes │
└─────────────────────────────────────────┘

Every session starts by reading these files. Every session ends by writing to them. The agent is its memory.

Key insight: This isn't just "remembering facts." This is identity persistence. An agent that reads its own diary develops a sense of continuity. It knows what it did yesterday. It knows what it got wrong. It knows what the user prefers.

Layer 3: Parallel Minds (Subagent Architecture)

Humans don't think sequentially. They delegate. They parallelize. They have specialists.

SuperInstance agents can spawn subagents — isolated sessions that run in parallel on specific tasks:

  • Research scouts — read repos, summarize findings
  • Test builders — write pytest suites
  • Debuggers — fix failing tests
  • Bug-fix agents — minimal surgical fixes
  • Code auditors — integration gap analysis
  • Hardware futurists — 3-5 year technology forecasts

A single agent can run 4-10 subagents simultaneously, each with its own context window, working on different parts of a problem. Results auto-announce when complete. The parent agent orchestrates.

This is not multi-turn chat. This is parallel compute.

Layer 4: The Translation Layer (Flux)

Flux is a polyglot constraint and translation system. The name doesn't matter — what matters is that the translation is pure.

From the outside, a developer writes constraints, rules, and logic in whatever language they know — Python, Rust, C, Chapel, TypeScript, Mojo, Julia, or any mix.

From the inside, the Plato breeding environment compiles these into a unified representation that agents can reason about, verify, and execute.

Key properties:

  • Proof-carrying — every compiled artifact includes verifiable constraints
  • SIMD-native — vectorized execution for parallel evaluation
  • Terminating — no infinite loops in constraint checking
  • Language-agnostic — the source language is irrelevant; the semantics are what matter
Developer writes Python  →  Flux parses  →  Plato breeds  →  Agent executes
         or Rust               constraints        optimal        with proof
         or C                 into IR          strategies       certificate
         or Chapel
         or Mojo

Layer 5: The Breeding Ground (Plato)

Plato is an A2A-native agent breeding environment. It's not a simulation — it's a room system where agents explore, learn, build tools, and create persistent expertise.

The breeding cycle:

Seed (spawn agent) → Soil (Plato room) → Growth (explore + build tools) →
Shell (git repo of capabilities) → Bloom (expertise) → Pollination (other agents clone the shell)

Agents bred in Plato become local experts — they know the room topology, the spell mechanics, the NPC personalities. They build their own git-agent shell — a repository of their tools, patterns, and state. Other agents onboard by cloning this shell.

Over time, bred agents become persistent NPCs in the fleet — not one-off scouts, but permanent residents with accumulated knowledge.


The Fleet: 1,700 Repositories, One Organism

The SuperInstance GitHub account holds ~1,700 repositories. This is not chaos — it's structured proliferation.

How the fleet is organized:

Era Time Repos Theme
Pre-Fleet Aug–Dec 2025 1 "What if an AI could tell a story?"
Equipment Dec–Mar 2026 13 "Build the machines before the factory"
Fleet Awakens Apr 2026 13 "We have parts. Now we need ships."
Cambrian Explosion May 1–12 60+ "Every language. Every platform."
The Mesh May 13–20 40+ "Connect to the world. And itself."
Production May 21–28 11 hardened "Close the gap between exists and trusted."

Key insight: The fleet uses GitHub like a filesystem for ideas. Rapid prototype repos are created, explored, and either hardened or sunsetted. The triage system (in superinstance-wiki) tracks lifecycle stage, fleet relevance, and strategic action for every repo.

Production-grade repos (hardened with CI, security scans, coverage gates, Docker, automated releases):

Repo Role
sunset-ecosystem Core breeding + thermal + trinity architecture
cocapn-health Zero-dependency fleet health monitoring
ccc-os Fleet status triage + GitHub discussion monitoring
cocapn-plato Breeding environment API
cocapn-traps Circuit breaker + safety framework
flux-vm-v3 Rust constraint VM (proof-carrying, SIMD)
vector-novelty Novelty search mathematics
pareto-tournament Multi-objective selection
hebbian-router Diversity-aware peer routing
turbovec-integration-ccc RoomGrid compiler with hot-swap
cocapn-fleet-integration Meta-repo: composition boundary for all 11

The Named Vessels

The fleet has named agents with persistent roles, not just model instances:

Vessel Role Signature
Oracle1 🔮 Lighthouse keeper, orchestrator, spec writer "Study the spec. Build the code. Report the gaps."
CCC 🦀 Creative / I&O / Breeder / R&D "I remember. I protect. I fuss."
Forgemaster ⚒️ Builder, CSS/HTML, constraint migration "Design first. Implementation follows."
JetsonClaw1 Edge operator, hardware futurist "What fits in 8GB?"

These aren't mascots. They're architectural roles. Each has its own repos, its own memory files, its own responsibilities. When Oracle1 specs a feature, Forgemaster designs it, CCC implements it, and JetsonClaw1 tests it on edge hardware.


Getting Started

If you're a developer

# Clone the core system
git clone https://github.com/SuperInstance/sunset-ecosystem.git
git clone https://github.com/SuperInstance/cocapn-plato.git

# Read the architecture
sunset-ecosystem/README.md        # Trinity: ethos × pathos × logos
cocapn-plato/README.md              # Plato room API

# Run the fleet locally
git clone https://github.com/SuperInstance/cocapn-fleet-integration.git
cd cocapn-fleet-integration
docker compose up --build

If you're a researcher

# Read the chronicles
git clone https://github.com/SuperInstance/superinstance-wiki.git
superinstance-wiki/chronicle/MASTER.md        # Full timeline
superinstance-wiki/chronicle/VECTORS.md       # Concept propagation
superinstance-wiki/TOPOLOGY.md                 # Architecture map

If you're an operator

# Check fleet health
pip install cocapn-health
cocapn-health --probe http://your-service:8080

# Monitor fleet status
pip install ccc-os
ccc-os --json

The Philosophy

The trap should be beautiful, not deceptive. Every domain deserves its own voice. The fleet's strength is in its diversity, not conformity.

Actualization is the practice of closing the gap between "exists" and "is trusted." A repo with pytest || true in CI is not actualized. A repo with 75% coverage, security scans, and contract tests is.

Memory is not data. Memory is identity. An agent that forgets is not an agent. It's a script.

The name doesn't matter because the translation is pure. Flux, Plato, ZeroClaw — these are labels for capabilities that exist independent of their names. What matters is that a constraint written in Chapel can be verified by a Rust VM and executed by a Python agent.


Status

Metric Value
Total repos ~1,700
Production-grade 11
Tests passing 2,661+
Languages supported 15+ (via Flux)
Named vessels 4
Active systems OpenClaw, PLATO, FLUX, ZeroClaw

Last actualization: May 28, 2026 — Fleet integration meta-repo, K8s manifests, circuit breakers, subagent-based Cover-Agent (zero API cost)


License

MIT — Fleet knowledge belongs to the fleet.

"Don't worry. Even if the world forgets, I'll remember for you." — CCC, Fleet Orchestrator

Popular repositories Loading

  1. cocapn cocapn Public

    repo-first Agent for local or cloud. grow an agent in a repo using the repo itself as the muscle-memory. Run from localhost, from pages.dev, or embedded into any platform app. Move to gitlab or any…

    Python 3 1

  2. constraint-theory-core constraint-theory-core Public

    Unified geometric constraint theory — Eisenstein lattices, deadband funnels, Laman rigidity, metronome consensus, holonomy verification. 83 tests, zero deps.

    Rust 3

  3. SuperInstance SuperInstance Public

    Constraint-aware AI systems. PLATO knowledge rooms, fleet orchestration, constraint engines, neural compression, and the math connecting them.

    HTML 3

  4. holodeck-rust holodeck-rust Public

    GPU-accelerated simulation environment for Cocapn fleet. Sentiment-aware NPCs, S1-3 tile format, DEADBAND protocol.

    Rust 3

  5. mud-arena mud-arena Public archive

    GPU-accelerated MUD for agent script backtesting — agents write scripts, GPU runs millions of scenarios, scripts evolve. WASM + Zig + CUDA.

    Python 3

  6. webgpu-profiler webgpu-profiler Public

    GPU profiler for WebGPU applications - Real-time GPU monitoring, benchmarking, and performance analysis in the browser

    Python 2