KI-Workflow

Zeltros Befehle sind auf KI-gestützte Entwicklung ausgelegt. Es geht darum, einem Agenten eine feste Umgebung zu geben, in der er arbeitet, damit er Ihre App baut, statt Infrastruktur zu erfinden.

Zeltro verkauft keine KI. Es steuert eine Agenten-CLI, die Sie installieren und bei der Sie sich anmelden, und Sie bezahlen den Anbieter direkt (oder gar nichts, mit einem lokalen Modell).

Sie haben noch keine? Wenn Sie die Zeltro-App zum ersten Mal öffnen, können Sie es mit unserem Schlüssel ausprobieren: Claude Code mit Claude Haiku, ohne Konto, ohne Karte und ohne eigenen Schlüssel, genug, um es an einem ersten Projekt auszuprobieren (eines pro Computer, solange der Vorrat reicht). Das läuft über Zeltros Server (siehe Datenschutz). Danach verbinden Sie Ihre eigene KI wie oben beschrieben; dann läuft nichts mehr über Zeltro.

Einen Agenten wählen#

zeltro ai-set --agent claude --model claude-opus-5-5
zeltro ai-set --agent codex  --model gpt-6-sol
zeltro ai-set --agent agy
zeltro ai-set --agent aider  --model anthropic/claude-sonnet-5 --api-key sk-ant-...
zeltro ai-set --agent qwen   --model qwen/qwen3-coder-30b-a3b-instruct --api-base https://openrouter.ai/api/v1 --api-key sk-or-...
zeltro ai-set --agent opencode --model openai/gpt-5.4-mini --api-key sk-...
zeltro ai-set --agent hermes   --model openrouter/qwen/qwen3-coder --api-key sk-or-...
zeltro ai-set --json-output          # inspect current settings (read-only)

Nach einer frischen Installation ist kein Agent gesetzt, und die KI-Befehle fordern Sie auf, zuerst zeltro ai-set auszuführen. Wenn Sie unsicher sind, wählen Sie claude und lassen das Modell leer, dann nutzt Claude Code sein eigenes Standardmodell.

Wählen Sie einen Agenten, der nicht installiert ist, installiert zeltro ai-set ihn so:

curl -fsSL https://claude.ai/install.sh | bash     # Claude Code
npm install -g @openai/codex                       # Codex
curl -fsSL https://antigravity.google/cli/install.sh | bash   # Antigravity CLI (agy)
npm install -g @qwen-code/qwen-code                # Qwen Code
curl -LsSf https://aider.chat/install.sh | sh      # Aider
npm install -g opencode-ai                         # OpenCode
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- \
  --non-interactive --skip-browser --skip-computer-use   # Hermes Agent

Zeltro gibt einen gespeicherten Schlüssel nur dort weiter, wo er passt. Codex bekommt einen Schlüssel nur, wenn er mit sk- beginnt (mit eigenem Endpunkt jeden Schlüssel), und Claude bekommt ihn als ANTHROPIC_API_KEY nur, wenn er mit sk-ant- beginnt. Codex ignoriert OPENAI_API_KEY, deshalb meldet Zeltro es mit dem Schlüssel an (codex login --with-api-key), und zwar in einem eigenen Codex-Home, ~/.zeltro/codex/<hash of the key>, in das Ihre config.toml verlinkt wird. Ihr eigenes ~/.codex und eine ChatGPT-Anmeldung darin bleiben unberührt, und jeder Schlüssel behält seinen eigenen Sitzungsverlauf für zeltro resume. Alles andere wird mit einer Warnung ignoriert, und die CLI nutzt ihre eigene Anmeldung. agy und Gemini bekommen einen gespeicherten Schlüssel als GEMINI_API_KEY (einen Gemini-API-Schlüssel von aistudio.google.com); agy nimmt keinen eigenen Endpunkt.

zeltro ai-set --json-output allein liest nur. Es installiert nichts, schreibt nichts und meldet Agent, Modell, Endpunkt, ob ein Schlüssel gespeichert ist, die Einstellung für den unbeaufsichtigten Modus und welche Agenten installiert sind.

Sie möchten günstigere oder lokale Modelle nutzen? Siehe Günstige und lokale Modelle. Qwen Coder auf OpenRouter kostet pro Token etwa 30-mal weniger als Claude Sonnet 5, und ein lokales Ollama-Modell kostet im Betrieb nichts.

Die Einstellungen liegen in /etc/zeltro-cli/.env. Ändern Sie sie immer mit zeltro ai-set, statt die Datei zu bearbeiten.

Antigravity CLI (agy)#

agy ist Googles CLI für Coding-Agenten und ersetzt Gemini CLI. Google hat Gemini CLI für private Google-Konten (kostenlos, AI Pro und Ultra) am 18.06.2026 eingestellt. Mit einem kostenpflichtigen Gemini-API-Schlüssel funktioniert Gemini CLI weiterhin, daher geht zeltro ai-set --agent gemini noch, ist in Zeltro aber veraltet.

zeltro ai-set --agent agy                        # sign in with Google the first time you run agy
zeltro ai-set --agent agy --api-key AIza...      # or a Gemini API key (aistudio.google.com)

Es wird als einzelnes Programm in ~/.local/bin installiert (ohne Node) und aktualisiert sich selbst. Um sich mit Google anzumelden, öffnen Sie ein Terminal und führen einmal agy aus. Beim ersten interaktiven Start fragt es außerdem nach einem Farbschema und zeigt Googles Bedingungen, in denen Sie festlegen, ob Google Ihre Unterhaltungen nutzen darf; diese Entscheidung überlässt Zeltro Ihnen. Mit einem Schlüssel setzt Zeltro "modelProvider": "gemini" in ~/.gemini/antigravity-cli/settings.json (ohne das ignoriert agy den Schlüssel) und entfernt es wieder, wenn Sie den Schlüssel löschen, damit die Google-Anmeldung wieder funktioniert. agy nimmt keinen eigenen Endpunkt und kann deshalb keine günstigen oder lokalen Modelle über --api-base nutzen.

Aider#

Codex, Claude und agy melden sich jeweils mit ihrem eigenen Konto an. Aider nicht. Es spricht direkt mit der API eines Anbieters und braucht deshalb ein Modell und einen Schlüssel, bevor es läuft:

# a hosted provider (the model prefix picks it)
zeltro ai-set --agent aider --model anthropic/claude-sonnet-5 --api-key sk-ant-...

# a local OpenAI-compatible server
zeltro ai-set --agent aider --model openai/qwen3-coder:30b \
  --api-key ollama --api-base http://localhost:11434/v1

Zeltro versieht den Schlüssel mit dem Anbieter aus dem Präfix des Modells (anthropic=sk-ant-...) oder mit openai, wenn es kein Präfix gibt. --api-base ist nur für OpenAI-kompatible Server gedacht (Ollama, LM Studio, OpenRouter, vLLM); lassen Sie es leer, um die gehostete API eines Anbieters zu nutzen. Aider committet normalerweise jede Änderung selbst. Zeltro startet es mit --no-auto-commits, damit seine Änderungen wie bei jedem anderen Agenten in Ihrem Arbeitsverzeichnis liegen bleiben.

Qwen Code#

Qwen Code ist ein Open-Source-Agent für das Terminal, der als Fork von Gemini CLI begann und um die Qwen-Coder-Modelle herum gebaut ist. Zeltro installiert ihn mit npm install -g @qwen-code/qwen-code.

Zeltro betreibt ihn im OpenAI-kompatiblen Modus (--auth-type openai, mit Schlüssel und Endpunkt in OPENAI_API_KEY und OPENAI_BASE_URL). Damit ist er der einfachste Weg zu einem günstigen gehosteten oder einem lokalen Modell:

# hosted, pay-as-you-go
zeltro ai-set --agent qwen --model qwen/qwen3-coder-30b-a3b-instruct \
  --api-base https://openrouter.ai/api/v1 --api-key sk-or-...

# local Ollama
zeltro ai-set --agent qwen --model qwen3-coder:30b \
  --api-base http://localhost:11434/v1 --api-key ollama

Qwens kostenlose OAuth-Anmeldung wurde am 15. April 2026 eingestellt, daher braucht er einen API-Schlüssel oder einen lokalen Endpunkt. Einen kostenlosen gehosteten Weg über Qwen selbst gibt es nicht. Außerdem will er Node 22+; unter Node 20 läuft er mit einer EBADENGINE-Warnung, aber das wird nicht unterstützt.

OpenCode#

OpenCode ist ein Open-Source-Agent für das Terminal, der mit fast jedem Anbieter funktioniert. Zeltro installiert ihn mit npm install -g opencode-ai. Er kann seine eigene Anmeldung nutzen (opencode auth login) oder einen Schlüssel, den Sie Zeltro geben:

# a hosted provider: the model is provider/model, as OpenCode names it
zeltro ai-set --agent opencode --model openai/gpt-5.4-mini --api-key sk-...
zeltro ai-set --agent opencode --model openrouter/deepseek/deepseek-v4.1-flash --api-key sk-or-...

# any OpenAI-compatible server (the model is the name that server uses)
zeltro ai-set --agent opencode --model qwen3-coder:30b \
  --api-base http://localhost:11434/v1 --api-key ollama

Der Schlüssel landet in der Variable, die der Anbieter des Modells liest (OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY oder GOOGLE_GENERATIVE_AI_API_KEY). Ein Endpunkt wird zu einem OpenAI-kompatiblen Anbieter namens zeltro, der nur für diesen Lauf in OPENCODE_CONFIG_CONTENT übergeben wird, sodass nichts in Ihre OpenCode-Konfiguration geschrieben wird. Zeltro schaltet für seine Läufe außerdem das automatische Update von OpenCode ab. OpenCode liest die AGENTS.md des Projekts von sich aus.

Hermes Agent#

Hermes Agent von Nous Research ist ein Open-Source-Agent mit vollständigem Coding-Werkzeugsatz. Zeltro installiert ihn mit seinem offiziellen Skript, ohne die optionalen Extras für Browser und Computer-Use, nach ~/.local/bin/hermes.

# a provider prefix picks Hermes's provider: openai/, openrouter/, anthropic/ or gemini/
zeltro ai-set --agent hermes --model openai/gpt-5.4-mini --api-key sk-...
zeltro ai-set --agent hermes --model openrouter/qwen/qwen3-coder --api-key sk-or-...

# any OpenAI-compatible server
zeltro ai-set --agent hermes --model qwen3-coder:30b \
  --api-base http://localhost:11434/v1 --api-key ollama

Ohne Präfix geht das Modell an den Anbieter, für den Hermes eingerichtet ist. Ein Endpunkt nutzt Hermes' Anbieter openai mit OPENAI_BASE_URL. Hermes liest die AGENTS.md des Projekts von sich aus. Metas JavaScript-Engine Hermes installiert ebenfalls einen Befehl namens hermes; Zeltro prüft deshalb, ob es den Agenten vor sich hat (hermes --version meldet „Hermes Agent“), bevor es ihn startet.

Unbeaufsichtigter Modus#

Von sich aus fragt ein KI-Agent vor jeder Dateiänderung und jedem Befehl nach. Das bremst zeltro create aus, das dem Agenten eine Aufgabe übergibt und erwartet, dass er sie selbstständig zu Ende bringt.

In der Desktop-App: standardmäßig an, pro Projekt#

Jedes Projekt hat in seinem Panel einen Schalter Arbeitet ohne Nachfragen, und der ist standardmäßig an. Ist er an, arbeitet die KI des Projekts, ohne zum Nachfragen anzuhalten. Schalten Sie ihn für ein Projekt aus, wenn Sie jeden Schritt selbst im Terminal des Agenten bestätigen möchten.

Die App macht das Sitzung für Sitzung. Wenn sie den Agenten eines Projekts startet, setzt sie ZELTRO_AI_UNATTENDED=1 (Schalter an) oder 0 (Schalter aus), und Zeltro macht daraus für diesen Lauf die passende Option des Agenten:

Die Bestätigungseinstellungen der Agenten ändert sie nicht. Das Einzige, was sie schreibt, ist die einmalige Zustimmung von Claude Code, "skipDangerousModePermissionPrompt": true in ~/.claude/settings.json, damit Claude nicht an seinem Warnbildschirm „bypass permissions“ stehen bleibt. Einen Schalter für den ganzen Rechner hat die App nicht.

Im Terminal: die eigene Einstellung des Agenten#

zeltro ai, zeltro create und zeltro resume folgen der eigenen Konfiguration des Agenten, es sei denn, ZELTRO_AI_UNATTENDED ist gesetzt (1 oder 0, für diesen Lauf, wie oben). Wenn zeltro ai-set zum ersten Mal in einem Terminal einen Agenten einrichtet, fragt es einmal nach. Sagen Sie ja, schreibt es die Einstellung in die eigene Konfigurationsdatei des Agenten, wo Sie sie sehen und rückgängig machen können:

zeltro ai-unattended                 # allow it for the current agent
zeltro ai-unattended codex --status  # report without changing anything
zeltro ai-unattended codex --revoke  # turn the prompts back on

zeltro ai-set --allow-unattended und --no-allow-unattended tun dasselbe im Rahmen einer Einstellungsänderung. In der App hat der Schalter eines Projekts Vorrang vor dieser Einstellung, außer bei agy und Hermes mit ausgeschaltetem Schalter.

Überschreiben pro Sitzung#

zeltro ai-set gilt global. Um für einen Lauf einen anderen Agenten, ein anderes Modell oder einen anderen Schlüssel zu nutzen, ohne die Einstellung zu ändern, setzen Sie diese Variablen in der Umgebung. Sie werden nie in die .env geschrieben:

ZELTRO_AI_AGENT=qwen \
ZELTRO_AI_MODEL=qwen/qwen3-coder-30b-a3b-instruct \
ZELTRO_AI_API_BASE=https://openrouter.ai/api/v1 \
ZELTRO_AI_API_KEY_FILE="$HOME/.openrouter-key" \
  zeltro ai "Add a health-check endpoint at /ping"

Nicht gesetzt heißt „den Wert aus ai-set nutzen“; gesetzt, aber leer heißt „für diesen Lauf löschen“. Ein unbekannter Agent, eine nicht lesbare Schlüsseldatei oder ein nicht installierter Agent bricht den Befehl ab, bevor irgendetwas läuft. Es wird nichts für Sie installiert; mit zeltro ai-set --install-only --agent <name> fügen Sie einen Agenten hinzu, ohne ihn zum Standard zu machen.

Die Sprachanweisung erreicht Claude Code und Qwen Code über --append-system-prompt, Codex über -c developer_instructions=..., Aider über --chat-language und Hermes über HERMES_EPHEMERAL_SYSTEM_PROMPT, sie gilt also auch bei zeltro resume. agy, Gemini CLI und OpenCode bieten keine Möglichkeit, ihren System-Prompt zu ergänzen. Deshalb setzt zeltro ai die Anweisung an den Anfang des Prompts, und eine fortgesetzte Sitzung von agy, Gemini oder OpenCode bekommt keine.

In der Zeltro-App sind KI-Profile (Einstellungen → KI-Profile) benannte Kombinationen aus Agent, Modell, Endpunkt und Schlüssel, die Sie pro Sitzung auswählen. Schlüssel werden verschlüsselt gespeichert, und ein Profil erreicht die CLI über genau diese Variablen. Das eingebaute Standardprofil nutzt die zeltro ai-set-Konfiguration des Hosts.

zeltro create: von der Idee zum laufenden Projekt#

zeltro create "A timeclock for employees in Django"
zeltro create "Set up n8n and configure a webhook that posts to Slack"
zeltro create "https://github.com/monicahq/monica"

create läuft in drei Schritten:

1. Einordnen. Ihr Agent wird nur gefragt, welcher Stack passt, und antwortet in JSON: ein Framework, um es von Grund auf zu bauen, alle fertigen Apps aus Zeltros Katalog, die wirklich passen, eine Datenbank und ein Projektname. Im Terminal wählen Sie aus einem Menü. Skripte und --one-off nehmen die erste Empfehlung.
2. Anlegen. Zeltro selbst führt zeltro new oder zeltro install aus. An diesem Schritt ist keine KI beteiligt.
3. Bauen. Zeltro schreibt die AGENTS.md des Projekts und übergibt Ihre ursprüngliche Idee als einmaligen zeltro ai-Lauf an den Agenten im Projekt. Der Agent baut nach den Konventionen des Frameworks, aktualisiert die README, startet die App neu und prüft, ob sie antwortet, bevor er fertig ist.

Verlangt die Idee nur die Installation einer App („set up Grafana“), entfällt Schritt 3: Der Installer hat bereits geprüft, ob die App antwortet, und ihre URL und Anmeldedaten ausgegeben.

Eingabeoptionen#

zeltro create "an idea"                  # argument
zeltro create -f spec.md                 # from a file
zeltro create < spec.md                  # stdin
cat spec.md | zeltro create              # pipe
zeltro create --one-off "..."            # no menus; take the top recommendation
zeltro create --classify-only "..."      # print the recommendation and stop; creates nothing

--classify-only fragt nie nach. Mit --json-output erhalten Sie ein maschinenlesbares Ergebnis; das nutzt die Zeltro-App. Scheitert der Agent selbst (falscher Schlüssel, ein Modell, das Ihr Konto nicht nutzen darf, kein Guthaben mehr), lautet das Ergebnis {"status":"error","error":"agent_failed","message":"Codex: <the agent's own error>"}, und Zeltro bricht ab, sobald der Agent einen 400, 401, 403 oder 404 meldet, statt dessen Wiederholungsversuche abzuwarten. "error":"no_stack" bedeutet, dass der Agent geantwortet, aber keine brauchbare Empfehlung gegeben hat. create meldet dieselben Codes.

Die Übergabe per AGENTS.md#

Wird ein Projekt mit create, new, clone oder install angelegt, schreibt Zeltro eine AGENTS.md in das Projektverzeichnis. Bei new, clone und install wechselt es danach per cd in das Projekt und übergibt Ihrem Agenten einen Prompt, dessen einzige Aufgabe es ist, diese Datei zu lesen. --one-off, --json-output oder ein Lauf ohne Terminal überspringen diese Übergabe.

AGENTS.md hält fest, was ein Agent braucht, um ohne Vorwissen in das Projekt einzusteigen:

• Lokale URL, Container-Name, Projektverzeichnis
• Die tatsächlich genutzte Datenbank, gelesen aus der .env des Projekts
• Befehlsmuster, die im Container funktionieren
• Hostnamen und Zugangsdaten der gemeinsamen Dienste
• Regeln (nie --json-output, python3 statt python, vor dem Abschluss mit curl prüfen)

Weil dieser Kontext auf der Festplatte liegt und nicht in einer Chat-Sitzung, übersteht er das Schließen des Terminals, einen Neustart und den Wechsel zwischen Agenten.

Die Datei wird bei jeder Übergabe neu erzeugt, aber nur zwischen ihren Markierungen. Alles, was Sie außerhalb des erzeugten Blocks schreiben, bleibt erhalten.

zeltro ai: ein Prompt im aktuellen Projekt#

cd ~/zeltro-projects/my-app
zeltro ai "Add a health-check endpoint at /ping"
zeltro ai --interactive "Let's refactor the auth flow"

Standard ist ein einmaliger Lauf: Der Agent bekommt den Prompt, erledigt die Arbeit und beendet sich. Der dauerhafte Kontext steht in AGENTS.md, daher steht jeder Prompt für sich.

Eine unbekannte Option ist ein Fehler, statt an den Prompt angehängt zu werden.

zeltro resume#

zeltro resume my-project

Startet das Projekt, falls es nicht läuft, und öffnet dann die letzte Sitzung des Agenten in diesem Projektverzeichnis wieder. Kann der Agent nicht fortsetzen, startet er eine neue Sitzung.

Nachrichten an andere Agenten-Sitzungen#

Wenn die Zeltro-App Agenten-Sitzungen in mehreren Projekten betreibt, auf einem oder mehreren Hosts, können diese einander Nachrichten schicken. Führen Sie diese Befehle in Ihrem Projektverzeichnis aus:

zeltro peers                                   # live sessions, as project@host
zeltro send blog api@shop -- "API is on v2 now"
zeltro send --all -- "Shared Postgres restarting in 5 minutes"
cat notes.md | zeltro send blog -- -           # message from stdin

Jedes Ziel muss aktiv sein, sonst wird nichts gesendet. Nachrichten sind auf 16 KB begrenzt. Eine eingehende Nachricht erscheint im Terminal als [Zeltro message from shop@shawn to blog, api] .... Sie kommt von einem anderen Agenten, nicht von Ihnen.

In der Zeltro-App können Agenten das Fenster der App auch für zwei Dinge nutzen: Hinweise (zeltro gui notify), etwa die Zugangsdaten für ein eingerichtetes Admin-Konto oder „Ihre Änderung ist fertig“, die kurz eingeblendet werden und in der Liste „Hinweise“ des Projekts bleiben; und API-Schlüssel oder Passwörter (zeltro gui secret), die direkt in die .env des Projekts gehen und so nie im Gespräch auftauchen. Details finden Sie in der Befehlsreferenz.

Hinweise für Agenten#

Wenn Sie ein Agent sind, der mit Zeltro arbeitet, lesen Sie /usr/local/share/zeltro-cli/AGENTS.md. Das ist die kompakte Plattform-Referenz, bewusst kurz gehalten, weil jedes Byte bei jedem Lauf bezahlt wird.

Die wichtigsten Regeln:

• Nie --json-output übergeben. Es unterdrückt jede für Menschen lesbare Ausgabe, auch die Unterscheidung zwischen Erfolg und Fehler, sodass Sie nicht erkennen können, ob ein Befehl funktioniert hat. Es ist nur für externe Skripte und GUIs gedacht.
• Immer explizite Argumente übergeben. Nichts fragt nach; ein fehlendes Pflichtargument ist ein harter Fehler mit einem Hinweis zur Verwendung.
• zeltro exec bevorzugen gegenüber den TTY-Varianten (zeltro bash, zeltro exec-tty*). Diese belegen ein Terminal und eignen sich nicht für Automatisierung.
• zeltro supervisor restart all, nie zeltro exec supervisorctl ....
• python3, nicht python. Für Django besser zeltro django manage <args>.

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