Zeltro CLI

Zeltro ist ein Docker-basierter Manager für lokale Entwicklungsumgebungen für PHP-, Python- und Node-Projekte – und zugleich ein Satz Leitplanken für KI-Coding-Agenten, die auf Ihrem Rechner arbeiten.

Es erledigt drei Dinge, die sich gegenseitig verstärken.


Ein Satz Dienste für alle Projekte#

Ein zeltro-postgres, ein zeltro-mariadb, ein zeltro-redis, ein zeltro-mongo und ein zeltro-memcached, gemeinsam genutzt von jedem Zeltro-Projekt auf dem Rechner. Auch bei zehn laufenden Projekten haben Sie von jedem höchstens einen.

  • Projekte sprechen sich mit Namen an. Jedes Projekt hängt im selben Docker-Netzwerk und ist dort über seinen Namen erreichbar. Ein Container kann also fetch('http://my-api/') oder psql -h zeltro-postgres ausführen, ganz ohne Netzwerkkonfiguration.
  • Kein Port-Roulette. Sie wählen nie einen Port. Jedes Projekt bekommt beim Anlegen eine eigene Adresse, und zeltro status zeigt sie an – kein localhost:3001 gegen :3002 gegen :3003, keine Tricks mit host.docker.internal.
  • Weniger Ressourcen. Aus sieben doppelten Postgres-Containern mit zusammen ~700MB wird einer mit ~100MB.
  • Keine Konflikte. Bringt die Compose-Datei eines Projekts eine eigene Datenbank oder einen Cache mit (Postgres auf 5432, MySQL auf 3306, Redis und so weiter), entfernt Zeltro diesen Dienst und verbindet die App mit dem gemeinsamen.

Fertig gebaute Laufzeitumgebungen#

Drei Basis-Images decken jeden unterstützten Stack ab: PHP 8.3, Python 3 und Node 22. In jedem läuft nginx unter supervisor.

Sie müssen nie ein Image suchen, Tags vergleichen oder ein Dockerfile schreiben. Im PHP-Image sind die Erweiterungen für MySQL, PostgreSQL, SQLite, Redis und MongoDB einkompiliert. Das Python-Image hat die Treiber für alle fünf, dazu Django, Flask, FastAPI, gunicorn und uvicorn. Das Node-Image bringt die Build-Werkzeuge mit, die npm für native Treiber braucht.

Was jedes Image enthält, steht unter Architektur.

Gemacht für KI-Agenten#

Sich selbst überlassen, richtet ein KI-Agent ein Projekt ein, wie es ihm gefällt – eigene Ports, eigene mitgelieferte Datenbank, eigene Compose-Datei –, ohne Rücksicht auf die zwölf anderen Projekte auf Ihrem Rechner. Zeltro gibt dem Agenten eine feste Umgebung, in der er arbeitet:

  • Eine stabile Plattform. Gemeinsame Dienste, ein Netzwerk, zugewiesene Adressen und bekannte Laufzeit-Images: Der Agent baut Ihre App, statt die Infrastruktur neu zu erfinden.
  • Weniger Tokens. Framework-Gerüste, Netzwerk, das Erzeugen von Secrets und über 200 App-Installationen sind vorgefertigt. Der Agent muss nicht in jeder Sitzung neu herausfinden, wie man nginx und php-fpm verbindet.
  • Kontext, der bleibt. Wenn Zeltro ein Projekt an Ihren KI-Agenten übergibt, schreibt es eine AGENTS.md mit Adresse, Datenbank und Befehlen des Projekts. So kann eine neue Agenten-Sitzung ohne Vorwissen direkt einsteigen.

Wie es weitergeht#

Installation Zeltro unter Linux, macOS oder Windows installieren (Beta-Installer, der WSL2 einrichtet)
Downloads Die Desktop-App und die CLI allein
Schnellstart Ihr erstes Projekt mit einem Befehl
Frameworks zeltro new – ein Projekt anlegen, das Sie selbst schreiben
App-Bibliothek zeltro install – über 200 startklare Apps
KI-Workflow zeltro create, ai, resume
Befehlsreferenz Jeder Befehl und jede Option
Architektur Dienste, Netzwerk, Basis-Images
Automatisierung & JSON Skripte, JSON-Ausgabe, Fehlersuche

Wo Zeltro wenig bringt#

Wenn Sie genau ein Projekt betreiben und nie ein anderes anfassen, reicht ein einfaches docker compose up. Zeltro lohnt sich, sobald sich mehrere Projekte oder ein KI-Agent einen Rechner teilen.

Einen Fehler in dieser Übersetzung gefunden? Sagen Sie es uns auf GitHub.