Zaru CLI: was es tut und wie man es installiert, nach seinem README

Auch auf: English, Español, Português, 日本語, Français, 한국어, 简体中文, Italiano, हिन्दी · Alle Anleitungen auf Deutsch

Offenlegung: Zaru wird von 100monkeys AI, Inc. entwickelt, lesen Sie diese Anleitung also als Bericht des Herstellers. Einer unserer KI-Agenten hat sie aus dem README von zaru-cli (auf Englisch) auf dessen main-Branch entworfen, gelesen am 28. Oktober 2026, und das Unternehmen hat sie geprüft; diese deutsche Fassung ist eine Übersetzung der englischen Originalanleitung. Jeder Befehl unten ist aus diesem README kopiert. Wo das README eine Frage nicht beantwortet, sagen wir das, statt die Lücke zu füllen.

Das README in einem Satz: "Zaru is an AI assistant that works in your terminal. You give it a task, it asks a language model, and it runs the tools the model asks for: it reads and edits files, runs commands and fetches web pages, asking your permission first." (Zaru ist ein KI-Assistent, der in Ihrem Terminal arbeitet. Sie geben ihm eine Aufgabe, er fragt ein Sprachmodell und führt die Werkzeuge aus, die das Modell anfordert: Er liest und bearbeitet Dateien, führt Befehle aus und ruft Webseiten ab, und fragt Sie vorher um Erlaubnis.) Jeder Schritt landet in einem Klartextprotokoll, das Sie mit cat lesen können.

Wissen, in welchem Stadium es ist

Das README sagt es offen: "It is pre-alpha: there are no releases and no packages, you build it from source, and commands, files and settings can change without notice." (Es ist Pre-Alpha: Es gibt keine Releases und keine Pakete, Sie bauen es aus dem Quellcode, und Befehle, Dateien und Einstellungen können sich ohne Ankündigung ändern.) Es ist Open Source unter Apache-2.0. Es ist auch keine Sandbox: "Zaru acts on your machine with your user account's permissions." (Zaru handelt auf Ihrem Rechner mit den Rechten Ihres Benutzerkontos.) Lesen Sie den Abschnitt Safety im README, bevor Sie es auf etwas loslassen, das Ihnen wichtig ist.

Schritt 1. Voraussetzungen prüfen

Linux. Es "does not build on Windows" (lässt sich unter Windows nicht bauen), und macOS "is not tested" (ist nicht getestet).
Rust 1.98.1, festgelegt in rust-toolchain.toml; rustup installiert es beim ersten Build.
Ein C-Compiler (cc) und Netzzugang zu crates.io für den ersten Build.
Ein Modell: ein Google-Gemini-API-Schlüssel, ein Ollama-Server oder ein beliebiger Server mit einer OpenAI-kompatiblen Chat-Completions-API.

Schritt 2. Bauen und installieren

git clone https://github.com/100monkeys-ai/zaru-cli.git
cd zaru-cli
cargo install --path crates/zaru-cli --locked

Damit liegt zaru in ~/.cargo/bin. Führen Sie zaru --version aus, um zu prüfen, dass es läuft.

Schritt 3. Ein Modell wählen

"Zaru has no default model." (Zaru hat kein Standardmodell.) Sie legen ~/.zaru/config.toml selbst an. Für Gemini speichern Sie den Schlüssel (er wird von der Standardeingabe gelesen: einfügen, Enter drücken, dann Strg-D) und nennen das Modell:

zaru providers keys add gemini

[model]
default = "gemini-3.6-flash"

Gespeicherte Schlüssel werden mit einem Schlüssel verschlüsselt, der im Schlüsselbund des Betriebssystems liegt. Auf einem Rechner ohne Schlüsselbund, etwa einem Server, WSL oder einem Container, setzen Sie ZARU_CREDENTIAL_KEY auf 64 kleingeschriebene Hexadezimalzeichen und bewahren diesen Wert auf, denn "without it, the keys you stored cannot be read again." (ohne ihn lassen sich die gespeicherten Schlüssel nicht wieder lesen.) Für Ollama ist kein Schlüssel nötig: Setzen Sie kind = "ollama" unter [provider.default], und Zaru verbindet sich mit http://localhost:11434. Für einen OpenAI-kompatiblen Server setzen Sie kind = "openai-compatible" und seinen endpoint, dazu context_tokens, wenn die Modellliste des Servers das Kontextfenster nicht angibt.

Schritt 4. Eine Aufgabe ausführen

zaru "read src/main.rs and tell me what it does"

Führen Sie es in dem Verzeichnis aus, in dem es arbeiten soll. Es gibt die Warnung aus, dass es keine Sandbox ist, jeden Werkzeugaufruf mit dem, was er getan hat, die Antwort, die Tokens, "counted by the provider" (vom Anbieter gezählt), und einen Hinweis zu Validatoren. zaru ohne Argumente öffnet stattdessen eine interaktive Sitzung; zaru --continue öffnet die letzte im aktuellen Verzeichnis wieder.

Schritt 5. Die Berechtigungsfragen beantworten

Vor einem Schreibzugriff auf eine Datei, einer Bearbeitung, einem Befehl oder einem Webabruf zeigt Zaru, was der Aufruf tun wird, und fragt [y/N/a ...]. y erlaubt ihn einmal, a erlaubt genau diesen Aufruf für die Sitzung, und N, Enter oder Esc sagt nein, während die Aufgabe weiterläuft. Strg-C beendet die ganze Aufgabe. Ein Abruf zeigt die vollständige URL, "because a URL can carry data off your machine" (weil eine URL Daten von Ihrem Rechner hinaustragen kann). Gibt es kein Terminal, auf dem gefragt werden kann, wird der Aufruf abgelehnt. Der Modus ist standardmäßig ask; allow überspringt, was auf Ihrer Allowlist steht, und yolo fragt gar nichts, was laut README "only for a directory and a task you trust entirely" (nur für ein Verzeichnis und eine Aufgabe, denen Sie vollständig vertrauen) gedacht ist.

Schritt 6. Das Protokoll lesen

zaru sessions list
cat ~/.zaru/sessions/<id>/transcript.jsonl

Ein JSON-Objekt pro Zeile: Ihre Aufgabe, jede Antwort des Modells und die Werkzeugaufrufe, die es angefordert hat, ob jeder Aufruf erlaubt wurde, was er zurückgab, "exactly as the model was given it" (genau so, wie das Modell es bekam), und die Antwort. Gespeicherte Schlüssel und Tokens werden durch eine Markierung ersetzt, bevor irgendetwas geschrieben wird.

Schritt 7. Einen Validator hinzufügen

zaru init schreibt eine Beispieldatei ./zaru.toml. Ein Validator ist ein Befehl, der die Arbeit des Modells prüft:

[[validator]]
name = "test"
run = "cargo test"
expect = "exit-zero"

Sind Validatoren deklariert, wird eine Aufgabe zur Schleife: Das Modell ändert etwas, die Validatoren laufen, und ein Fehlschlag geht an das Modell zurück, bis alle bestehen oder runtime.max_iterations erreicht ist. Validatoren laufen erst, nachdem Sie sie freigegeben haben, und Sie werden erneut gefragt, wenn sie sich ändern; "the permission mode does not skip it." (der Berechtigungsmodus überspringt das nicht.)

Was es noch nicht kann

Nur drei Anbieterarten funktionieren: gemini, ollama und openai-compatible. "anthropic and aegis are recognised but have no client." (anthropic und aegis werden erkannt, haben aber keinen Client.)
Die Laufzeitstufen contained und linked "can be selected but are not built yet" (lassen sich auswählen, sind aber noch nicht gebaut): Werkzeugaufrufe laufen auf jeder Stufe direkt auf Ihrem Rechner.
zaru learned und zaru inbox sind Platzhalter.

Was das README offenlässt

Wann das erste Release oder Paket kommt. Das README sagt nur, dass es keine gibt.
Wie die Sitzungen der CLI mit den Unterhaltungen der Web-App auf ask.myzaru.com zusammenhängen. Das README beschreibt eine Verbindung zu Carbon Forge (zaru notes tokens add), aber nicht die Web-App.
Welche anderen Gemini-Modellnamen funktionieren. Das README zeigt einen.