A macOS-first, Swift-native control plane for visible, durable, graph-aware multi-agent engineering.
Andromeda replaces fragmented scripts, hidden workers, ad-hoc memory stores, provider-specific model wiring, and silent background automation with one observable system.
Andromeda is not HUD + memory alone. It is the local-first Swift control plane:
| # | Pillar | Role |
|---|---|---|
| 1 | Memory (Anima) | Durable recall/store behind memory.* / infer.write / project.state.* |
| 2 | MCP home | Host/consolidate MCPs so Studio does not run ~50 npm processes |
| 3 | Agent skills home | Registry/surface for skills agents use (SkillRegistry) |
| 4 | LLM proxy | Andromeda-owned inference routing (Autocache/gateway lineage); clients do not pick providers |
| 5 | Secrets vault / broker | Stable IDs like slack_proxy, github_proxy, write.too — never raw keys in client env |
| 6 | Fleet runtime | LaunchAgents / plists / launchd + observability + telemetry — visible, auditable, accessible |
Clients see stable capability IDs; Andromeda resolves providers, secrets, MCP processes, and LaunchAgents behind the curtain. Honesty table (✅/🚧/📐) and examples: docs/ANDROMEDA-CONTROL-PLANE.md. Workspace flip remains gated — pillars are product scope, not a flip claim.
flowchart LR
Observe[Observe events and outcomes] --> Evolve[Evolve from evidence]
Evolve --> Execute[Execute controlled capabilities]
Execute --> Internalize[Internalize durable knowledge]
Internalize --> Observe
flowchart TD
Clients[Agents, Apps, CLIs, MCP Clients] --> Gateway[Andromeda Gateway API]
Gateway --> Router[Capability Router]
Gateway --> Execution[Execution Engine]
Gateway --> Knowledge[Knowledge API]
Router --> Providers[Provider Adapters]
Execution --> Tools[Tools and MCP]
Knowledge --> Journal[Durable Event Journal]
Journal --> Graph[Graph Projector]
Journal --> Obsidian[Obsidian Projector]
Graph --> Neo4j[Neo4j Projection]
Obsidian --> Vault[Markdown Vault]
Neo4j --> Search[Search and Retrieval]
Vault --> Search
Gateway --> Telemetry[OSLog, OTel, OpenInference, Phoenix]
Router --> Telemetry
Execution --> Telemetry
Journal --> Telemetry
- No project-maintained Bash automation files.
- No invisible
launchctljobs, hidden watchdogs, or mystery daemons. - Every background job appears in a command-bar, menu-bar, console, or equivalent status surface.
- Every important action has structured logs, metrics, traces, ownership, privacy labels, and failure state.
- Acknowledged observations are written to a durable journal before downstream processing.
The Gateway spine is moving from plan to code. The first live Hummingbird surface is a Swift port of Autocache: an Anthropic Messages proxy that injects prompt-cache breakpoints and returns ROI analytics headers.
Broader OpenAI-compatible routing, bidirectional MCP, encrypted evidence, privacy filters, and Phoenix telemetry remain on the roadmap.
swift build
swift test
swift run andromeda status
ANTHROPIC_API_KEY=sk-ant-... swift run andromeda serve --port 8080Point Anthropic clients at http://127.0.0.1:8080 instead of https://api.anthropic.com. Compatible headers include X-Autocache-Injected, X-Autocache-Cache-Ratio, and X-Autocache-ROI-Percent.
- Control plane — six pillars ← agents: read this first for product scope
- Memory architecture (Anima) ← memory vision + website reference: 8 layers, 7 services, the curtain, why graph+vector, proof
- Swift package hierarchy ← MemoryKit → Anima → Andromeda target tree (BIN-151)
- Charter
- Roadmap
- Changelog
- Agent guidance
- Claude guidance
- Workspace readiness / flip gate
- Sequence diagrams
- Gateway architecture
- Autocache Swift port
- Gateway Swift stubs
- Main Brain
Andromeda is under active migration. Do not treat generated projections, model outputs, or retrieved notes as authoritative unless provenance and confidence support that claim.