MiniCode: Ein schlanker Terminal-Coding-Assistent zum Studieren
Ein leichter Terminal-Codierungsassistent mit Claude Code-ähnlichem Workflow, Tool-Loop und TUI-Architektur, der zum Lernen und Experimentieren entwickelt wurde. Mehrsprachige Unterstützung: TypeScript-, Python- und Rust-Implementierungen jetzt verfügbar.
Auf einen Blick
- Was ist das?
- MiniCode von LiuMengxuan04 bringt den Workflow eines modernen Coding-Agenten in eine kompakte TypeScript-Implementierung: Tool-Schleife, Vollbild-TUI, Sitzungspersistenz und MCP-Anbindung. Das Projekt ist als Lern- und Experimentierbasis gedacht und wird zusätzlich in Rust, Python, Go und Java gepflegt.
- Für wen ist es gedacht?
- MiniCode eignet sich für Entwickler, die verstehen wollen, wie ein Terminal-Agent mit Tool-Loop, Freigabe-Flows und Kontextverdichtung im Inneren funktioniert, denn die Codebasis ist bewusst klein und dokumentiert. Wer eine ausgereifte Produktivitätsplattform sucht, wird mit dem Kompaktkurs nicht glücklich; vor dem Start sollte man über den Installer Modellname, ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN setzen.
- Darf ich es kommerziell nutzen?
- Ja. MIT ist eine freizügige Lizenz: Sie dürfen darauf aufbauende Software nutzen, verändern und verkaufen, solange Sie die Urheberrechts- und Lizenzhinweise beibehalten.
- Wird es noch gepflegt?
- Ja. Die letzten Commits kamen vor 7 Tagen.
- In welcher Sprache ist es geschrieben?
- Hauptsächlich TypeScript, laut der Sprachstatistik von GitHub.
Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 14. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.
TIEFGEHENDE OPEN-SOURCE-ANALYSE
Der Agent-Loop von MiniCode im Terminal
MiniCode läuft als Terminal-Coding-Assistent für lokale Entwicklungsworkflows und orientert sich am Workflow bekannter Coding-Agenten, verpackt ihn aber in eine deutlich kleinere Implementierung. Der Ablauf folgt einer festen Schleife: eine Nutzeranfrage annehmen, den Workspace inspizieren, bei Bedarf Werkzeuge aufrufen, Dateiänderungen vor dem Schreiben prüfen und am Ende eine Antwort in derselben Terminal-Sitzung zurückgeben.
Innerhalb eines Zuges dürfen mehrere Werkzeuge nacheinander laufen, sodass eine model-tool-model-Kette entsteht. Bis zu drei nebenläufige, nur lesende Sub-Agenten können zusätzlich arbeiten; der Root-Agent behält alle Codeänderungen für sich und kann Arbeiter anhalten oder schließen. Diese Arbeitsteilung hält die Kontrolle über Schreiboperationen an einer Stelle.
Die Oberfläche ist eine Vollbild-TUI mit Eingabehistorie, scrollbarem Transkript, Slash-Befehlsmenü und Freigabe-Flows. Dateiänderungen werden vor dem Schreiben zur Durchsicht vorgelegt, und Pfad- sowie Befehlsberechtigungen werden geprüft, bevor etwas ausgeführt wird.
Kontextstatistiken, Auto-Compact und geschichteter Speicher
Ein Thema, das MiniCode über das Niveau eines Spielzeugs hebt, ist das Langsitz-Kontextsystem, das Mitinitiator GateJustice beigesteuert hat. Es zählt die Nutzung pro Anbieter, schätzt die verbleibende Kontextlücke am Ende ab, verdichtet den Kontext automatisch und kennt einen Context Collapse sowie snip compact für große Blöcke.
Übermäßige Tool-Ergebnisse werden nicht dauerhaft in den Kontext gepresst: Sie landen auf der Festplatte, und im Kontext bleibt nur eine kurze Vorschau mit Dateipfad zurück. Damit bleibt die Konversation auch bei langen Suchergebnissen handhabbar.
Zusätzlich gibt es einen geschichteten Speicher, den Core-Beitragender GoDiao beigesteuert hat, zusammen mit dem Befehl /init und Sitzungswiederaufnahme. Der Befehl /memory zeigt an, welche Speicherdateien für den aktuellen Zug geladen wurden, was das Verhalten des Agenten nachvollziehbar macht.
Sitzungen pro Projekt: fortsetzen, umbenennen, abspalten
MiniCode persistiert Sitzungen pro Projekt und bietet dafür resume, rename, fork und compact als Kommandos. Wer an mehreren Projekten parallel arbeitet, bekommt getrennte Verläufe, und die Sitzungsauswahl öffnet sich über /resume.
Die wichtigsten Einstiegspunkte in der TUI sind /help für die interaktive Hilfe, /tools für die Liste der Werkzeuge, /status für Sitzungs- und Kontextstatus sowie /model beziehungsweise /model <name> zum Wechseln des Modells. /compact verdichtet den Kontext von Hand, wenn die automatische Verdichtung nicht abwarten will.
Für die Verwaltung außerhalb der TUI existieren die Befehle minicode mcp und minicode skills. Die vollständige Befehlsreferenz mit Konfigurationsbeispielen liegt im Usage Guide unter USAGE.md im Repository.
Skills über SKILL.md und MCP über stdio oder HTTP
MiniCode entdeckt lokale Fähigkeiten automatisch über SKILL.md-Dateien, und der Befehl /skills listet alles auf, was im Workspace gefunden wurde. Damit lassen sich projekt eigene Abläufe definieren, ohne den Kern der Anwendung anzupassen.
Über das Model Context Protocol kommen weitere Werkzeuge, Ressourcen und Prompts hinzu, entweder über stdio oder über eine entfernte HTTP-Verbindung. Der Verbindungsstatus lässt sich mit /mcp prüfen. Wer eigene MCP-Server betreibt, konfiguriert sie in ~/.mini-code/mcp.json.
Die eingebauten Werkzeuge decken Dateien, Suche, Bearbeitung, Befehlsausführung, Web-Fetch und Web-Suche sowie Klärungsfragen ab. Die Kombination aus eingebauten Werkzeugen, Skills und MCP macht die kleine Basis zu einem erstaunlich vollständigen Agenten.
Installation, Konfiguration und Offline-Modus
Die Installation läuft über drei Befehle im geklonten Verzeichnis mini-code: npm install, gefolgt von npm run install-local. Der Installer fragt nach dem Modellnamen, ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN und legt die Konfiguration in ~/.mini-code/settings.json sowie ~/.mini-code/mcp.json ab.
Über die Umgebungsvariablen MINI_CODE_HOME und MINI_CODE_BIN_DIR lassen sich das Konfigurationsverzeichnis und das Launcher-Verzeichnis an andere Orte verlegen. Gestartet wird der installierte Launcher mit minicode, in der Entwicklung mit npm run dev.
Für Tests ohne echtes Modell gibt es einen Offline-Demo-Modus, der über MINI_CODE_MODEL_MODE=mock npm run dev gestartet wird. Damit lässt sich die TUI und der Werkzeugloop erkunden, ohne API-Kosten zu erzeugen, was für das Studium der Architektur praktisch ist.
Fazit: Eine Referenzimplementierung in fünf Sprachen
MiniCode positioniert sich explizit als leichtgewichtige Alternative zu großen Plattformen und als Referenzimplementierung für die Architektur eines Terminal-Agenten. Wer wissen will, wie Tool-Loops, Freigabe-Flows und Kontextverdichtung zusammenspielen, kann das hier in einer überschaubaren Codebasis nachlesen; das Dokument CLAUDE_CODE_PATTERNS.md erklärt die Designmuster zusätzlich.
Bemerkenswert ist die Mehrsprachigkeit des Projekts: Neben der TypeScript-Fassung in diesem Repository gibt es MiniCode-rs in Rust von harkerhand, MiniCode-Python von QUSEATIONS, eine Go-Version sowie MiniCode4j in Java. Mit rund 1.100 Sternen und der MIT-Lizenz ist der Einstieg für Beiträge niedrig, die Richtlinien liegen in CONTRIBUTING.md.
Für den produktiven Alltag ist die Anwendung brauchbar, wenn man ein Terminal-Werkzeug statt einer IDE-Integration will. Wer ernsthaft mitarbeiten will, startet mit ARCHITECTURE.md, dann mit MINI_CODE_MODEL_MODE=mock npm run dev, um Änderungen ohne Modellzugriff zu testen, und wirft einen Blick auf den Roadmap-Eintrag ROADMAP.md für offene Baustellen.
Redaktionelles Fazit
MiniCode eignet sich für Entwickler, die verstehen wollen, wie ein Terminal-Agent mit Tool-Loop, Freigabe-Flows und Kontextverdichtung im Inneren funktioniert, denn die Codebasis ist bewusst klein und dokumentiert. Wer eine ausgereifte Produktivitätsplattform sucht, wird mit dem Kompaktkurs nicht glücklich; vor dem Start sollte man über den Installer Modellname, ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN setzen.
Community-Notizen