Open source · MIT1100+ tests67 skills · 15 MCP tools

Maggy, srooter>'s open-source AI engineering harness.

From the team behind srooter>: Maggy is our open-source harness that turns Claude Code, Codex, Kimi, and Gemini CLI into a test-enforced, quality-gated workflow, with cost-aware routing across 13 model tiers, cross-session memory, and a plugin system. Run it locally, own every line. Point it at srooter> when your team needs a governed gateway.

View on GitHub What makes it different
$git clone https://github.com/alinaqi/maggy.git && cd maggy && ./install.sh
Reach for Maggy when you want to
  • Run your own multi-model routing locally, your keys, cheapest capable model per task.
  • Add a real engineering harness to your CLI, TDD, gates, memory, agent teams.
  • Self-host and own it end to end, open source, no account, no gateway required.

Two parts, one repo

Start with Bootstrap in 30 seconds; add the Maggy server when you want routing, protocols, and the dashboard.

Claude Bootstrap

An installable config pack (67 skills, hooks, rules, templates) that drops into ~/.claude/ and applies on your next session. Roughly 30-second install; works with Claude Code, Codex, Kimi, and Gemini CLI.

The Maggy server

An optional local FastAPI server plus web dashboard adding 13-tier routing, skill protocols, the Cortex code graph over MCP, Polyphony isolation, and plugins. maggy serve → localhost:8080

Core systems

Everything Maggy adds, in one place.

13-tier routingcost-aware

Every task goes to the cheapest model that can actually do it.

  • Each message is scored 1-10 for complexity and risk (the "blast score") and classified by task type, all locally, by a free Qwen3 classifier, so triage costs nothing.
  • The score selects a tier: T0 Qwen3 (local) for classification and bulk ops, climbing through DeepSeek, Kimi, Gemini, Grok, and Codex, up to Claude Sonnet/Opus (T11 to T12) for architecture and security review. Roughly 80% of real work lands on the cheap-but-strong middle tiers.
  • Budget-capped with auto-demotion: when an org nears its cap, routing steps down to cheaper tiers instead of blocking. Fatigue-aware and cascading, a failed call falls back down the chain.
Skill protocolsworkflows

Deterministic, intent-matched workflows, not just prompts.

  • Protocols are YAML files (maggy/skills/protocols/). When your intent matches one ("push to git", "ship a feature"), Maggy runs the steps in order with real gates.
  • Example, git-push: lint, typecheck, tests, stage, commit (with an AI-written message), push. Any failing step halts the protocol; nothing ships half-done.
  • Drop a .yaml to add your own. 67 bundled skills cover Python, TypeScript, React, React Native, Flutter, Supabase, Stripe, Playwright, security, ADRs, and cross-agent delegation.
Telosbeyond TDD

Tests tell you it passes; Telos tells you it fulfils its intent.

  • Telos scores work on an Intent Fidelity Scale: IFS = F1 x F2 x F3 across three planes, Conformance (does it meet the written spec), Validation (does it do the right thing), and Integrity (is it sound and safe).
  • The score is multiplicative: a zero in any single plane collapses the total to zero. You cannot pass by acing two planes and ignoring the third.
  • Ships as a plugin, so it runs as part of the pipeline rather than as a manual afterthought.
Cortex MCPcode intelligence

A queryable code graph any harness can use over MCP.

  • Cortex builds a code-property graph with 10 edge types, cyclomatic-complexity metrics, FTS5 full-text search, and bidirectional traversal, all in a single SQLite database.
  • It exposes 15 MCP tools, so Claude Code, Codex, or any MCP client can ask structured questions ("what calls this", "what would this change break") instead of grepping.
  • Benchmarked against plain codebase-memory approaches: graph traversal beats flat RAG for "why" and "blast radius" questions.
Polyphonyparallel agents

Run multiple agents on one repo without file conflicts.

  • Concurrent agent sessions each get a Docker-isolated workspace, auto-provisioned when a second session starts.
  • Because each agent works in its own isolated checkout, parallel work never clobbers another agent's files, the classic failure mode of running multiple agents on a shared repo.
  • Isolation modes let you choose how strict the separation is for a given run.
Engram + Mnemosmemory

Memory that survives compaction and persists across weeks.

  • Mnemos is task-scoped memory with a four-dimension fatigue model and typed checkpoints. It ingests Claude Code session transcripts, scores how "hazy" each session is, and auto-checkpoints before context is lost.
  • When context compacts, Mnemos restores the typed checkpoint instead of making you re-explain the task, freeing tokens while keeping the thread.
  • Engram is the long-horizon layer: it persists architectural knowledge across weeks and handles seven distinct "amnesia" types so decisions do not evaporate between sessions.
iCPGintent graph

Stores why code exists, not just what it is.

  • The intent-augmented Code Property Graph records the reasoning behind code, ReasonNodes and constraints, alongside the structure.
  • It detects drift across six dimensions, flagging when an implementation has wandered from its stated intent.
  • And it prevents duplicate implementations: before building something new, the graph can tell you it already exists.
Agent teams + gatesdiscipline

A six-agent TDD pipeline with enforcement that does not depend on remembering.

  • Six roles run each feature: Lead, Quality, Security, Review, Merger, and Feature, a real pipeline, not one model doing everything.
  • Stop-hooks enforce TDD: tests must pass before a task is considered done. No green, no merge.
  • Quality gates are enforced per file, max 20 lines per function, 3 parameters, 2 nesting levels, and non-trivial changes require an ADR (reverse-engineered from git history if one is missing).

Routing: 13 tiers, cheapest capable wins

Every message is scored 1-10 for complexity and classified by task type (locally, by Qwen3). Trivial asks stay free and local; hard architecture climbs to Claude. Budget-capped, with auto-demotion.

T0Qwen3 (local)Classification, triage, free bulk ops
T1Gemini Flash-LiteBulk extraction, pipelines
T2DeepSeek FlashDocs, tests, scaffolding
T3Gemini FlashMultimodal, vision, audio
T4DeepSeek ProComplex coding, refactors
T5Gemini CLIMulti-file agentic coding
T6AGYEnd-to-end (git + code + test)
T7KimiLong-context analysis
T8Gemini Pro SearchDeep research, 2M context
T9GrokCompetitor intel, reasoning
T10CodexBulk generation, security-sensitive
T11Claude SonnetQuality-critical code, debugging
T12Claude OpusArchitecture, security, ADRs

Plugins: drop-in extensions

A simple plugin system: drop one in and it hooks into Maggy's events. Ships with several out of the box.

Build-in-Public

Turns shipped work into posts and publishes to LinkedIn, X, and Reddit, with a voice engine (plain-text, no em-dashes) and a comment-reply heartbeat.

Project providers

GitHub, Asana, and Monday providers wire tasks and issues into the harness.

Telos plus your own

Telos ships as a plugin; write your own with a small plugin.yaml plus plugin.py.

What makes Maggy different

Most "AI engineering" tools are either an autonomous agent loop (Hermes-style) that replaces your CLI, or a thin wrapper that adds nothing. Maggy is a discipline and routing layer that augments the tools you already use.

MaggyAutonomous agent frameworksRaw Claude Code
Multi-model routingYes: 13 tiers, cheapest capable modelUsually single model / BYO loopNo: one model for everything
Discipline enforcedTDD stop-hooks + quality gates + ADRsOptional, prompt-dependentNone
Cross-session memoryEngram / Mnemos, survives compactionRare / vector-store bolt-onLost each session
Code intelligenceiCPG + Cortex MCP (why code exists)Usually plain RAG over filesNone
Parallel safetyPolyphony, Docker-isolated workspacesManual / conflicts on shared repoN/A
Works with your CLIAugments Claude Code / Codex / Kimi / GeminiReplaces your tools with its ownn/a
Open sourceMIT, 1100+ tests, self-hostableVariesClosed

What it looks like

You: "review the auth middleware for timing attacks"
→ Blast score: 8/10 (security + architecture)
→ Routed to: Claude (Tier 12)
→ ADR gate: found docs/adr/0003-jwt-strategy.md → injected as context
→ Review runs with full architectural context

You: "push to git"
→ Intent matched: git-push protocol
→ ✅ lint · ✅ typecheck · ✅ tests · ✅ commit (AI-written) · ✅ push

Maggy and srooter>

They fit together. Maggy is the harness, local, free for individual developers, picking the right model and enforcing engineering discipline. srooter> is the gateway, the governed, audited, multi-tenant layer a team routes all of that traffic through for budgets, policy, and compliance. Point Claude Code at either; use Maggy solo and free, add srooter> when a team needs governance. Neither locks you in.

View on GitHub See the benchmarks
Maggy: open-source AI engineering harness · srooter