AgentiLoopGo

🌐 English · Español · Français · Deutsch · 中文 (简体) · Русский · 한국어 · 日本語

🎉 Wir haben Version v0.0.5 für Mac, Windows und Linux veröffentlicht!

Probier es aus! Lies das README und schau, wie lange du brauchst, bis AgentiLoop läuft. Wenn du auf Probleme stößt, sag uns Bescheid. Wir freuen uns über dein Feedback.

Bonus: Es gibt auch eine Rust-Version: AgentiLoopCLI → https://github.com/AgentiLoop/AgentiLoopCLI

Probier beide aus und sag uns, welche es besser macht: Go oder Rust? 🐹 vs 🦀

💖 Unterstütze AgentiLoop

Gefällt dir, was du siehst? Hilf mit, dass AgentiLoop schnell und plattformübergreifend bleibt. Unterstütze uns über GitHub Sponsors → AgentiLoop. Stufen und Vorteile findest du im Sponsoring-Leitfaden.

AgentiLoop ist ein KI-Coding-Agent, der in deinem Terminal läuft, ganz im Stil von Claude Code. Du beschreibst in normaler Sprache, was du willst. Der Agent liest deine Dateien, bearbeitet Code und führt Befehle aus, um es umzusetzen, und er fragt dich um Erlaubnis, bevor er irgendetwas ändert.

Er ist in Go geschrieben und läuft auf macOS, Linux und Windows. Er ist der Go-Zwilling von AgentiLoopCLI (Rust): gleiche Funktionen, gleiche Optionen, gleiche Einstellungs-, Sitzungs- und MCP-Dateien, sodass du beliebig zwischen beiden wechseln kannst. Er funktioniert mit Claude (Anthropic), OpenAI, lokalen Modellen über Ollama oder LM Studio sowie oMLX auf Apple Silicon.

Erstellt mit AgentiLoop Agent! Das ist unser Baby. Fertige Binärdateien für macOS, Linux und Windows findest du auf der Seite Releases, oder du kompilierst es selbst aus dem Quellcode mit Go.

🚀 Neu hier? In 5 Minuten startklar

Kein Rust, kein Go, kein Kompilieren. Du lädst eine Datei herunter, gibst ihr einen API-Schlüssel und fängst an zu chatten. Geh die Schritte der Reihe nach durch.

1. AgentiLoop herunterladen

Finde zuerst heraus, welche Datei du brauchst:

Dein Computer	Herunterzuladende Datei
Mac mit Apple Silicon (M1, M2, M3, M4…)	`agentiloop-macos-arm64.tar.gz`
Mac mit Intel-Chip	`agentiloop-macos-x86_64.tar.gz`
Linux, 64-Bit-PC	`agentiloop-linux-x86_64.tar.gz`
Linux auf ARM (Raspberry Pi 4/5, ARM-Server)	`agentiloop-linux-arm64.tar.gz`
Windows 10/11	`agentiloop-windows-x86_64.zip`

Nicht sicher? Führ auf Mac oder Linux uname -m aus. arm64 oder aarch64 bedeutet arm64, und x86_64 bedeutet x86_64.

macOS und Linux. Öffne das Terminal und füge diese Zeilen ein. Das Beispiel verwendet die Apple-Silicon-Datei; ändere also macos-arm64 in den ersten drei Zeilen, falls deine anders ist:

curl -LO https://github.com/AgentiLoop/AgentiLoopGo/releases/download/v0.0.5/agentiloop-macos-arm64.tar.gz
tar xzf agentiloop-macos-arm64.tar.gz
mkdir -p ~/.local/bin && mv agentiloop-macos-arm64/agentiloop ~/.local/bin/

Damit landet das Programm in ~/.local/bin, einem Ordner in deinem Home-Verzeichnis. In Schritt 3 sagst du deinem Terminal, dass es dort suchen soll.

Windows. Öffne PowerShell (Startmenü → "PowerShell" eintippen) und füge ein:

Invoke-WebRequest https://github.com/AgentiLoop/AgentiLoopGo/releases/download/v0.0.5/agentiloop-windows-x86_64.zip -OutFile agentiloop.zip
Expand-Archive agentiloop.zip -DestinationPath $HOME\agentiloop -Force
$p = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$p;$HOME\agentiloop\agentiloop-windows-x86_64", "User")

Die letzten beiden Zeilen fügen AgentiLoop zu deinem PATH hinzu. Schließ PowerShell und öffne ein neues Fenster, damit die Änderung übernommen wird.

2. Einen API-Schlüssel besorgen

AgentiLoop ist der Agent. Das „Gehirn" ist ein KI-Modell, mit dem du ihn verbindest. Wähle eins aus:

Option	Wo du ihn bekommst	Kosten
Claude (empfohlen)	console.anthropic.com → Create Key. Er beginnt mit `sk-ant-`	Bezahlung nach Nutzung
OpenAI	platform.openai.com/api-keys. Er beginnt mit `sk-`	Bezahlung nach Nutzung
Ollama (läuft auf deinem eigenen Computer)	Installiere es von ollama.com und führ dann `ollama pull qwen2.5-coder` aus	Kostenlos, kein Schlüssel

Kopier den Schlüssel an einen sicheren Ort. Du fügst ihn im nächsten Schritt ein.

3. Deine Einstellungen im Shell-Profil speichern

Dein Shell-Profil ist eine kleine Textdatei, die dein Terminal jedes Mal liest, wenn es ein neues Fenster öffnet. Trag deine Einstellungen dort ein, dann musst du das nur einmal machen. Wenn du das überspringst, musst du deinen Schlüssel in jedem neuen Terminal erneut eingeben. Das ist der häufigste Grund, warum Leute hängen bleiben.

Welche Datei ist das?

System	Shell (Standard)	Profildatei
macOS (Catalina 10.15 und neuer)	zsh	`~/.zshrc`
Die meisten Linux-Distributionen	bash	`~/.bashrc`
Linux oder Mac mit zsh	zsh	`~/.zshrc`
fish-Shell	fish	`~/.config/fish/config.fish`
Windows	PowerShell	nicht nötig, siehe unten

Du weißt nicht, welche Shell du benutzt? Führ echo $SHELL aus. ~ steht für deinen Home-Ordner, ~/.zshrc ist also z. B. /Users/you/.zshrc. Dateien, die mit einem Punkt beginnen, sind im Finder und in Dateimanagern ausgeblendet, das ist normal.

Öffne die Datei. Nimm einen dieser Befehle (sie legen die Datei an, falls es sie noch nicht gibt):

nano ~/.zshrc                        # funktioniert überall, direkt im Terminal
touch ~/.zshrc && open -e ~/.zshrc   # macOS: öffnet sie in TextEdit

(Linux mit bash: nimm ~/.bashrc statt ~/.zshrc.)

Füge diese Zeilen ganz unten hinzu. Behalte nur die Schlüsselzeile, die du brauchst, und füge deinen echten Schlüssel zwischen den Anführungszeichen ein:

# AgentiLoop
export PATH="$HOME/.local/bin:$PATH"

export ANTHROPIC_API_KEY="sk-ant-paste-your-key-here"          # Claude
# export OPENAI_API_KEY="sk-paste-your-key-here"               # OpenAI
# export OPENAI_BASE_URL="http://localhost:11434/v1"           # Ollama (kein Schlüssel nötig)

Speichern und schließen. In nano: Ctrl-O, Enter, dann Ctrl-X. In TextEdit: ⌘S, dann das Fenster schließen.

Laden. Öffne entweder ein neues Terminalfenster oder führ aus:

source ~/.zshrc

fish verwendet eine andere Syntax. Schreib das in ~/.config/fish/config.fish:

fish_add_path $HOME/.local/bin
set -gx ANTHROPIC_API_KEY "sk-ant-paste-your-key-here"

Windows (PowerShell). Unter Windows gibt es dafür keine Profildatei zum Bearbeiten. Speichere den Schlüssel stattdessen als Benutzer-Umgebungsvariable (das macht auch der Einrichtungsassistent, wenn du Option 2 wählst):

setx ANTHROPIC_API_KEY "sk-ant-paste-your-key-here"
# oder: setx OPENAI_API_KEY "sk-..."   /   setx OPENAI_BASE_URL "http://localhost:11434/v1"

Dann schließ PowerShell und öffne ein neues Fenster. setx wirkt sich nicht auf das Fenster aus, in dem es ausgeführt wird. Du kannst das auch mit der Maus erledigen: Start → Edit environment variables for your account → New….

🔒 Halte deinen Schlüssel geheim. Committe deine Profildatei nicht in git und füge den Schlüssel nicht in Chats ein. Auf dem Mac kannst du ihn stattdessen im Schlüsselbund aufbewahren; siehe Schritt 2 im Schnellstart.

4. Prüfen, ob es funktioniert

agentiloop --version

Du solltest agentiloop 0.0.5 sehen. Prüf jetzt, ob der Schlüssel geladen ist:

echo $ANTHROPIC_API_KEY | cut -c1-10    # macOS / Linux: sollte sk-ant-... ausgeben

$env:ANTHROPIC_API_KEY.Substring(0,10)  # Windows PowerShell

Wenn nichts ausgegeben wird, geh zurück zu Schritt 3. Der Schlüssel ist noch nicht geladen.

5. Deine erste Sitzung

Wechsle in einen Projektordner und starte die Vollbild-Oberfläche:

Fang mit einem neuen, leeren Testordner an, dann kannst du gefahrlos ausprobieren. Für ein echtes Projekt wechselst du stattdessen mit cd in dessen Ordner (zum Beispiel cd ~/code/my-app).

mkdir -p ~/agentiloop-test
cd ~/agentiloop-test
agentiloop --tui

Du nutzt Ollama? Gib den Anbieter und ein Modell an, das du heruntergeladen hast: agentiloop -p openai -m qwen2.5-coder --tui.

Jetzt tippst du einfach in normaler Sprache ein, was du willst, und drückst Enter. Ein paar gute erste Anfragen:

erklär mir, was dieses Projekt macht
liste die Dateien in src auf und sag mir, welche der Einstiegspunkt ist
finde die TODO-Kommentare und fasse sie zusammen
füge dem Kommandozeilen-Parser eine Option --verbose hinzu
führ die Tests aus und behebe alles, was fehlschlägt
erstelle eine README.md für dieses Projekt

Bevor der Agent eine Datei ändert oder einen Befehl ausführt, fragt er dich. Drück y für ja, n für nein, a, um dieses Tool für die Sitzung immer zu erlauben, oder Esc, um den Schritt zu überspringen. Mit Ctrl-C beendest du das Programm. Beim nächsten Mal startet ein einfaches agentiloop genauso und macht mit deiner letzten Unterhaltung weiter.

Du willst nur eine Antwort ohne Chat? Übergib die Frage als Argument:

agentiloop "explain what this project does"

Was kann er? (Tools)

Der Agent arbeitet mit neun eingebauten Tools. Du rufst sie nicht selbst auf. Du beschreibst das Ziel, und der Agent wählt das Tool:

Tool	Was es macht	Fragt vorher?
`read_file`	Liest eine Datei (mit Zeilennummern)	Nein
`list_dir`	Listet die Dateien in einem Ordner auf	Nein
`glob`	Findet Dateien nach Namensmuster (`.rs`, `src//.go`)	Nein
`grep`	Durchsucht Dateien mit einem regulären Ausdruck	Nein
`web_fetch`	Lädt eine Webseite oder API-Antwort als reinen Text	Ja
`todo_write`	Führt die eigene Checkliste des Modells für mehrstufige Aufgaben	Nein
`write_file`	Erstellt eine neue Datei oder überschreibt eine	Ja
`edit_file`	Ändert eine exakte Textstelle in einer Datei	Ja
`bash`	Führt einen Shell-Befehl aus, z. B. Tests, Builds oder `git` (`sh -c` auf Mac/Linux, `cmd /C` unter Windows)	Ja

Du willst mehr Tools, etwa Websuche, Datenbanken oder GitHub? Füge MCP-Server hinzu; siehe Tools mit MCP hinzufügen.

Der Hilfe-Befehl

agentiloop --help listet alle Optionen auf:

$ agentiloop --help
AgentiLoop — a cross-platform agentic coding loop for your terminal.

Usage: agentiloop [OPTIONS] [PROMPT]...

Arguments:
  [PROMPT]...  One-shot prompt. If omitted, starts an interactive REPL. A lone `-` in it is replaced by
               what is piped on stdin: git diff | agentiloop "review this" -

Options:
  -p, --provider PROVIDER           Model backend (PROVIDER): anthropic, openai (OpenAI-compatible: OpenAI, Ollama,
                                    LM Studio, Groq, OpenRouter, … via OPENAI_BASE_URL), omlx (local
                                    oMLX server, http://localhost:8000/v1), or codex (ChatGPT plan via
                                    `codex login`). Defaults to the last one used, then auto-detected from
                                    which credentials are set. [env: AGENTILOOP_PROVIDER]
  -m, --model MODEL                 MODEL id to use. Defaults to the last model used with this provider
                                    (~/.agentiloop/settings.json), then the provider's default. [env: AGENTILOOP_MODEL]
      --yes                         Skip all permission prompts (dangerous; intended for CI). Never remembered. [env: AGENTILOOP_YES]
      --max-turns N                 Max provider round-trips (N) per prompt [default: last used, then 50]
      --compact-at TOKENS           Summarize the conversation once a request reaches this many input TOKENS (0 = never)
                                    [default: last used, then 80% of the model's context window] [env: AGENTILOOP_COMPACT_AT]
  -C, --cwd DIR                     Working directory (DIR) the agent operates in (defaults to cwd)
  -r, --resume ID                   Resume a saved session by ID (see /sessions)
  -c, --continue                    Resume the most recent session for this working directory
                                    (the default for interactive launches; kept for scripts)
      --new                         Start a new session instead of continuing the last one in this directory
      --tui                         Full-screen terminal UI instead of the line REPL. Remembered. [env: AGENTILOOP_TUI]
      --no-tui                      Use the line REPL even if the TUI was used last time
      --no-mcp                      Don't start MCP servers from ~/.agentiloop/mcp.json / ./.mcp.json. [env: AGENTILOOP_NO_MCP]
      --setup                       Run the first-time setup wizard (provider, key, model). Runs by itself on a
                                    machine with no credentials and no ~/.agentiloop.
      --reset                       Back to brand new: delete ~/.agentiloop (settings, env, history, sessions,
                                    mcp.json), the agentiloop block in your shell profile and Keychain items the
                                    wizard created. Asks first unless --yes.
      --allow-tool NAME             Run this tool without asking (repeatable or comma-separated; NAME* matches a prefix, e.g. mcp_*)
      --deny-tool NAME              Never run this tool NAME; the model is told it was denied (same name rules). Beats --allow-tool and --yes
      --append-system-prompt TEXT   Extra TEXT added to the end of the system prompt for this run (never saved). [env: AGENTILOOP_APPEND_SYSTEM_PROMPT]
      --json                        One-shot only: print the answer as one JSON object on stdout (result, is_error, session_id,
                                    provider, model, usage) instead of streaming text. Tool activity still goes to stderr.
  -h, --help                        Print help
  -V, --version                     Print version

Tippe in einer Sitzung /help, um die Chat-Befehle zu sehen (/model, /sessions, /resume, /clear, /compact, /mcp, /exit). Die vollständige Referenz findest du unter Alle Optionen und Befehle im Chat.

Hängst du fest? Schnelle Lösungen

Du siehst	Lösung
`command not found: agentiloop`	`~/.local/bin` ist nicht in deinem PATH. Füge die Zeile `export PATH=...` aus Schritt 3 hinzu und öffne dann ein neues Terminal. Unter Windows öffnest du ein neues PowerShell-Fenster
`Error: no provider credentials found`	Es ist kein Schlüssel geladen. Mach Schritt 3 noch einmal und prüf es dann mit Schritt 4
macOS: "agentiloop" cannot be opened / unidentified developer	Das passiert, wenn du mit einem Browser statt mit `curl` heruntergeladen hast. Führ `xattr -d com.apple.quarantine ~/.local/bin/agentiloop` aus
Windows: Windows protected your PC	Klick auf More info → Run anyway
`401` / `invalid x-api-key` / Authentifizierungsfehler	Der Schlüssel ist falsch oder enthält Leerzeichen oder Anführungszeichen. Kopier ihn erneut und prüf die Zeile in deinem Profil
Ollama: Modell nicht gefunden	Führ `ollama list` aus und übergib den exakten Namen mit `-m`
Er benutzt immer noch ein altes Modell oder einen alten Anbieter	Er merkt sich deine letzte Wahl. Übergib `-p` / `-m`, um sie zu ändern, oder führe `agentiloop --reset` aus, um von vorn zu beginnen

Kommst du immer noch nicht weiter? Eröffne ein Issue und füge den Befehl und die Fehlermeldung ein. Wir helfen dir.

Schnellstart

Drei Schritte: installieren, ein Modell verbinden, starten.

Schritt 1: Installieren

Herunterladen: Hol dir das Archiv für deine Plattform unter Releases, entpacke es und leg agentiloop (agentiloop.exe unter Windows) in deinen PATH.

Oder selbst bauen: Wenn du Go noch nicht hast (1.25 oder neuer), installiere es über go.dev/dl. Dann:

go install github.com/AgentiLoop/AgentiLoopGo/cmd/agentiloop@latest

oder aus einem Klon:

git clone https://github.com/AgentiLoop/AgentiLoopGo.git
cd AgentiLoopGo
go install ./cmd/agentiloop

Damit wird das Programm gebaut und ein agentiloop-Befehl in deinem PATH abgelegt, in ~/go/bin (%USERPROFILE%\go\bin unter Windows). Ein C-Compiler ist nicht nötig.

Keine Installation? Alles in diesem README funktioniert auch direkt im Repo-Ordner. Wo immer du agentiloop <options> siehst, tippst du stattdessen go run ./cmd/agentiloop <options>.

Schritt 2: Ein Modell verbinden

AgentiLoop braucht ein Modell, mit dem es sprechen kann.

Am einfachsten: Führe einfach agentiloop aus. Auf einem Rechner ohne eingerichteten Schlüssel startet ein kurzer Assistent: Er fragt, welchen Anbieter du möchtest, nimmt deinen Schlüssel entgegen (versteckt eingegeben), prüft die Verbindung, lässt dich ein Modell wählen und speichert den Schlüssel in ~/.agentiloop/env (nur AgentiLoop liest sie). Du kannst ihn jederzeit mit agentiloop --setup erneut starten, und agentiloop --reset setzt alles auf den Anfangszustand zurück.

agentiloop --setup          # Assistent im normalen Terminal
agentiloop --setup --tui    # Assistent in der Vollbild-TUI (wie im Screenshot)
/setup                      # in einer laufenden Sitzung erneut starten (REPL oder TUI)

Der Assistent läuft in der Oberfläche, die du benutzt. agentiloop --setup stellt seine Fragen im normalen Terminal; agentiloop --setup --tui (oder eine gemerkte TUI) stellt sie in der Vollbild-Oberfläche wie im Screenshot und bringt dich danach direkt zur Eingabezeile. In einer laufenden Sitzung macht /setup in beiden dasselbe.

Von Hand: Setze stattdessen eine dieser Variablen in deinem Terminal:

Ich möchte nutzen…	So geht's
Claude (Anthropic)	`export ANTHROPIC_API_KEY=sk-ant-...`
OpenAI	`export OPENAI_API_KEY=sk-...`
Ollama, LM Studio oder einen beliebigen OpenAI-kompatiblen Server	`export OPENAI_BASE_URL=http://localhost:11434/v1` (nimm die Adresse deines Servers; lokale Server brauchen keinen Schlüssel)
oMLX (lokale Modelle auf Apple Silicon)	Normalerweise nichts. Starte oMLX und führ AgentiLoop dann mit `-p omlx` aus (siehe unten)

Für Claude kannst du einen normalen API-Schlüssel (sk-ant-api…) oder ein Claude-Code-Token (sk-ant-oat01-…, das du mit claude setup-token bekommst) verwenden. AgentiLoop erkennt, um welche Art es sich handelt.

Details zu oMLX. Wenn oMLX auf demselben Mac läuft, liest AgentiLoop den Server-Port und den API-Schlüssel aus der eigenen Einstellungsdatei von oMLX (~/.omlx/settings.json), du musst also nichts exportieren. Läuft oMLX auf einem anderen Rechner oder willst du diese Einstellungen überschreiben, exportiere sie selbst:

export OMLX_BASE_URL=http://192.168.1.50:7777/v1   # die Adresse des oMLX-Servers (oder OMLX_PORT=7777 für localhost)
export OMLX_API_KEY=...                            # der API-Schlüssel aus den oMLX-Einstellungen

Wenn in oMLX die Prüfung des API-Schlüssels ausgeschaltet ist, brauchst du keinen Schlüssel.

Ein export gilt nur für den Terminal-Tab, in dem du ihn eingegeben hast. Damit er dauerhaft gilt, füge die Zeile deinem Shell-Profil hinzu (~/.zshrc auf macOS). Auf dem Mac kannst du den Schlüssel im Schlüsselbund statt in der Datei aufbewahren:

# einmalig: den Schlüssel im Schlüsselbund speichern
security add-generic-password -a "$USER" -s ANTHROPIC_API_KEY -w "sk-ant-..."

# in ~/.zshrc: ihn für jedes neue Terminal laden
export ANTHROPIC_API_KEY="$(security find-generic-password -a "$USER" -s ANTHROPIC_API_KEY -w 2>/dev/null)"

Schritt 3: Starten

Wechsle in das Projekt, an dem du arbeiten willst, und starte AgentiLoop:

cd ~/my-project
agentiloop --tui

--tui öffnet die Vollbild-Oberfläche, die wir empfehlen. Tipp ein, was du willst, z. B. „finde heraus, wo die Konfigurationsdatei geladen wird, und füge eine Option --verbose hinzu", und drück Enter.

Du siehst die Antworten des Agenten, jedes Tool, das er benutzt (🔧), und jedes Ergebnis (✓ oder ✖). Der Kasten unten zeigt, was er gerade tut, zum Beispiel ✻ Thinking... 12s. Bevor er eine Datei schreibt oder einen Befehl ausführt, fragt er dich:

y: ja, dieses Mal
n: nein
a: dieses Tool für den Rest der Sitzung immer erlauben
Esc: diesen Schritt überspringen, aber weitermachen

Drei Arten, es zu benutzen

Modus	Befehl	Gut für
TUI (Vollbild)	`agentiloop --tui`	Den Alltag: scrollbarer Verlauf, Live-Status, klickbare Links
Chat (Zeile für Zeile)	`agentiloop`	Einfache Terminals, oder wenn du reinen Text bevorzugst
Einmalig	`agentiloop "explain this project"`	Eine einzelne Frage: Er antwortet und beendet sich dann. Praktisch in Skripten
Per Pipe	`git diff \| agentiloop "review this" -`	Text per Pipe übergeben und `-` im Prompt setzen: Es wird durch den Pipe-Inhalt ersetzt. Praktisch für Diffs und Logs

Tasten in der TUI: Enter sendet · ↑ / ↓ blättern durch frühere Anfragen · PgUp / PgDn oder das Mausrad scrollen · Ctrl-U löscht die Zeile · Ctrl-C beendet.

Er merkt sich deine Einstellungen

Du gibst deine Optionen nur einmal ein. AgentiLoop speichert, wie du es gestartet hast, sodass beim nächsten Mal ein einfaches agentiloop genauso startet:

agentiloop -p anthropic --tui    # beim ersten Mal: Anbieter und TUI wählen
agentiloop                       # ab jetzt: gleicher Anbieter, gleiches Modell, TUI und deine letzte Unterhaltung

Was er sich merkt:

Anbieter (-p) und TUI an/aus (--tui / --no-tui)
Modell: das zuletzt benutzte, getrennt für jeden Anbieter. Wechselst du zu einem Anbieter zurück, kommt auch sein Modell zurück.
Limits: --max-turns und --compact-at
Deine Unterhaltung: Er macht mit der letzten Unterhaltung im aktuellen Ordner weiter, sofern diese denselben Anbieter benutzt hat. Die früheren Nachrichten werden wieder auf dem Bildschirm angezeigt, sodass du zurückscrollen und sehen kannst, wo du aufgehört hast

Um etwas zu ändern, übergib die neue Option. Sie gilt sofort und wird ab dann gemerkt:

agentiloop -p omlx        # zu oMLX wechseln (sein zuletzt benutztes Modell kommt auch zurück)
agentiloop -m <model>     # Modell wechseln
agentiloop --no-tui       # zurück zum zeilenweisen Chat
agentiloop --new          # eine neue Unterhaltung beginnen (die alte bleibt gespeichert)

Manche Dinge werden absichtlich nie gemerkt:

--yes: Das Überspringen der Berechtigungsabfragen muss jedes Mal eine bewusste Entscheidung sein
--no-mcp, -C und einmalige Anfragen
API-Schlüssel: Die bleiben in deinem Shell-Profil

Um alles zu vergessen, führe agentiloop --reset aus.

Alle Optionen

Jede Option lässt sich auch über eine Umgebungsvariable setzen, die in der zweiten Spalte steht. Eine Option, die du eintippst, hat immer Vorrang vor einem gemerkten Wert.

Option	Umgebungsvariable	Was sie macht
`-p, --provider <name>`	`AGENTILOOP_PROVIDER`	`anthropic`, `openai` oder `omlx`. Wenn du keinen angibst, nimmt AgentiLoop den letzten oder erkennt ihn anhand deiner Schlüssel (zuerst Anthropic, dann OpenAI, dann oMLX)
`-m, --model <id>`	`AGENTILOOP_MODEL`	Welches Modell benutzt wird
`--tui` / `--no-tui`	`AGENTILOOP_TUI`	Vollbild-Oberfläche an / aus
`--new`		Beginnt eine neue Unterhaltung, statt weiterzumachen
`-c, --continue`		Macht hier mit der letzten Unterhaltung weiter (ist schon Standard)
`-r, --resume <id>`		Öffnet eine bestimmte Unterhaltung erneut (IDs findest du mit `/sessions`)
`-C, --cwd <folder>`		Arbeitet in einem anderen Ordner als dem, in dem du gerade bist
`--yes`	`AGENTILOOP_YES`	Fragt nicht, bevor Tools ausgeführt werden. ⚠️ Nur für vertrauenswürdige, automatisierte Nutzung
`--allow-tool <name>`		Führt dieses Tool ohne Nachfrage aus; Option wiederholen oder Kommas nutzen. `mcp_*` passt auf ein Präfix. Gut für CI ohne `--yes`
`--deny-tool <name>`		Führt dieses Tool nie aus: Das Modell erfährt, dass es abgelehnt wurde. Hat Vorrang vor `--allow-tool` und `--yes`
`--no-mcp`	`AGENTILOOP_NO_MCP`	Startet keine MCP-Server (siehe unten)
`--append-system-prompt <text>`	`AGENTILOOP_APPEND_SYSTEM_PROMPT`	Zusätzlicher Text am Ende des System-Prompts für diesen Lauf (wird nicht gespeichert)
`--json`		Bei einer einmaligen Anfrage: gibt die Antwort als ein JSON-Objekt (`result`, `is_error`, `session_id`, `provider`, `model`, `usage`) auf stdout aus. Tool-Aktivität bleibt auf stderr
`--setup`		Startet den Einrichtungsassistenten erneut (Anbieter, Schlüssel, Modell). Zusammen mit `--tui` läuft er in der Vollbild-Oberfläche
`--reset`		Zurück auf Anfang: löscht `~/.agentiloop`, den agentiloop-Block in deinem Shell-Profil und die vom Assistenten angelegten Schlüsselbund-Einträge (unter Windows: die von ihm gesetzten Benutzer-Umgebungsvariablen). Von Hand geschriebene `export`-Zeilen werden nur auskommentiert, und nur wenn du zustimmst. Mit `--yes` entfallen die Rückfragen
`--max-turns <n>`		Maximale Anzahl Schritte, die der Agent pro Anfrage machen darf (Standard 50)
`--compact-at <tokens>`	`AGENTILOOP_COMPACT_AT`	Wann eine lange Unterhaltung zusammengefasst wird (Standard 150000, `0` = nie)
`-h` / `-V`		Hilfe / Version

Ein paar Beispiele:

agentiloop -p openai -m gpt-4o-mini "summarize this repo"    # eine Frage mit einem bestimmten Modell
agentiloop -C ../other-repo --tui                            # an einem anderen Projekt arbeiten
agentiloop --yes "run the tests and fix any failures"        # unbeaufsichtigt, ohne Rückfragen

Welches Modell wird benutzt? Das erste, das zutrifft, gewinnt:

-m auf der Kommandozeile
das Modell der Unterhaltung, die du fortsetzt
das letzte Modell, das du mit diesem Anbieter benutzt hast
der Standard des Anbieters: claude-sonnet-5 für Anthropic, gpt-4o-mini für OpenAI oder das erste Modell, das oMLX anbietet

Befehle im Chat

Tipp diese an der Eingabeaufforderung ein, in der TUI oder im Chat:

Befehl	Was er macht
`/model`	Zeigt die verfügbaren Modelle. `/model 3` oder `/model <id>` wechselt (und wird gemerkt)
`/sessions`	Listet deine gespeicherten Unterhaltungen auf, die neueste zuerst
`/resume <n or id>`	Öffnet eine davon erneut
`/clear`	Leert die Unterhaltung und beginnt eine neue
`/undo`	Macht die Dateiänderungen des Agenten für deinen letzten Prompt rückgängig (Änderungen durch `bash`-Befehle nicht)
`/todos`	Zeigt die aktuelle Aufgaben-Checkliste des Modells
`/diff`	Zeigt, was sich im Git-Arbeitsverzeichnis geändert hat (Status plus Diff, nach 200 Zeilen gekürzt)
`/commands`	Eigene Befehle: Jede `.agentiloop/commands/<name>.md` (Projekt) oder `~/.agentiloop/commands/<name>.md` wird zu `/<name>` und sendet die Datei als Prompt (`$ARGUMENTS` wird durch das Folgende ersetzt, `$1`–`$9` durch die einzelnen Wörter). Zeigt die Liste
`/init`	Erstellt eine `AGENTS.md`-Vorlage für das aktuelle Projekt (überschreibt nie)
`/export [file]`	Speichert die Unterhaltung als Markdown-Datei (`/export notes.md` oder ein Standardname im Projektordner)
`/compact`	Fasst die Unterhaltung jetzt zusammen, um Platz zu schaffen
`/usage`	Zeigt die seit dem Start verbrauchten Tokens und wie voll der Kontext ist
`/mcp`	Zeigt die verbundenen MCP-Server und ihre Tools
`/help`	Listet diese Befehle auf
`/exit`	Beenden

Lange Unterhaltungen

Modelle können nur eine begrenzte Menge auf einmal lesen. Wenn eine Unterhaltung groß wird (standardmäßig, wenn eine Anfrage 150.000 Tokens erreicht), bittet AgentiLoop das Modell, das Bisherige zusammenzufassen, und macht auf Basis der Zusammenfassung weiter. Du siehst dann einen 📦-Hinweis. /compact macht das auf Wunsch, und --compact-at 0 schaltet es ab.

Projektanweisungen

Lege eine Datei AGENTS.md (oder CLAUDE.md) in dein Projekt, und AgentiLoop liest sie beim Start und befolgt sie: Build-Befehle, Code-Stil, Dinge, die zu vermeiden sind. Gesucht wird im aktuellen Ordner und dann in den übergeordneten Ordnern bis zum Projektstamm (dem Ordner mit .git). Eine persönliche ~/.agentiloop/AGENTS.md gilt für jedes Projekt; die Datei des Projekts kommt danach und hat Vorrang. Dateien werden bei 32 KB abgeschnitten. Eine Zeile instructions: <Pfad> zeigt, welche Dateien geladen wurden. Eine Zeile, die nur @pfad enthält (z. B. @docs/style.md), wird durch den Text dieser Datei ersetzt, relativ zur erwähnenden Datei. Importe können drei Ebenen tief verschachtelt sein; fehlende Dateien, Schleifen und Zeilen in Codeblöcken bleiben unverändert.

Tools mit MCP hinzufügen (optional)

MCP-Server geben dem Agenten zusätzliche Tools, etwa Datenbankzugriff, Websuche oder deine eigenen Skripte. Führ sie in einer JSON-Datei auf:

~/.agentiloop/mcp.json: in jedem Projekt verfügbar
.mcp.json in einem Projektordner: nur in diesem Projekt. Kommt ein Name in beiden Dateien vor, gewinnt diese hier.

Das Format ist dasselbe, das auch Claude Code, Claude Desktop und Agent! benutzen, du kannst also vorhandene Konfigurationen kopieren:

{ "mcpServers": {
    "Local":  { "command": "my-mcp-server", "args": ["--flag"], "env": { "API_KEY": "${MY_KEY}" } },
    "Remote": { "url": "https://example.com/mcp", "headers": { "Authorization": "Bearer ${TOKEN}" } }
} }

So funktioniert es:

Zwei Arten von Servern. Ein Server mit command ist ein lokales Programm, das AgentiLoop für dich startet. Ein Server mit url wird über HTTP erreicht. Sowohl neuere „Streamable HTTP"- als auch ältere „SSE"-Server funktionieren; eine URL, die auf /sse endet (oder "transport": "sse"), wählt den älteren Stil.
Tool-Namen. Jedes Server-Tool erscheint für den Agenten als mcp_<server>_<tool>, z. B. mcp_Local_search.
Geheimnisse. ${VAR} (oder ${VAR:-default}) wird aus deiner Umgebung befüllt, Schlüssel müssen also nicht in der Datei stehen.
Berechtigungen. MCP-Tools fragen wie jedes andere Tool um Erlaubnis, außer der Server markiert ein Tool als schreibgeschützt.
Prompts. Gespeicherte Prompts eines Servers werden zu Slash-Befehlen namens /mcp__<server>__<prompt>, z. B. /mcp__Local__summarize irgendein Text. Wörter nach dem Befehl füllen die Argumente des Prompts der Reihe nach (oder name=wert); der vom Server gelieferte Text wird als dein Prompt gesendet. /mcp listet sie auf.
Server abschalten. Füge "disabled": true hinzu, um einen Server zu überspringen, oder starte mit --no-mcp, um alle zu überspringen.
Sicherheit. Unverschlüsseltes http:// ist nur für localhost erlaubt; entfernte Server brauchen https://.

Tipp /mcp, um zu sehen, welche Server verbunden sind, welche Tools sie haben und ob es Fehler gibt.

Wo alles gespeichert wird

Alles liegt in ~/.agentiloop/. Setz AGENTILOOP_HOME, um einen anderen Ordner zu benutzen, z. B. ein separates Testprofil.

Datei	Was drinsteht
`settings.json`	Gemerkter Anbieter, Modelle und Optionen sowie was der Assistent an anderer Stelle geschrieben hat
`env`	Dein Schlüssel, vom Assistenten geschrieben (`KEY=value`, Dateimodus 600). Wird beim Start geladen; ein `export` in deiner Shell hat Vorrang
`sessions/`	Deine Unterhaltungen, je eine Datei
`mcp.json`	Deine MCP-Server
`history.txt`	Anfragen, die du eingetippt hast (für ↑ / ↓)

Weitere Umgebungsvariablen

Die brauchst du selten:

Variable	Zweck
`ANTHROPIC_BASE_URL`	Schickt Anthropic-Anfragen an einen Proxy oder kompatiblen Server
`ANTHROPIC_OAUTH_TOKEN`	Alternative zu `ANTHROPIC_API_KEY` für ein Claude-Code-Token
`OMLX_BASE_URL`, `OMLX_PORT`, `OMLX_API_KEY`	Adresse und Schlüssel des oMLX-Servers. Sie überschreiben `~/.omlx/settings.json`, das standardmäßig gelesen wird (Port 8000, wenn keins von beiden gesetzt ist)
`AGENTILOOP_LOG=debug` (oder `RUST_LOG=debug`)	Zeigt Debug-Logs, einschließlich des Token-Verbrauchs pro Anfrage

Für Entwickler

Bauen und testen

go build -o agentiloop ./cmd/agentiloop   # → ./agentiloop
go test ./...                             # läuft offline, keine API-Schlüssel nötig

Cross-Kompilieren braucht nichts Zusätzliches, zum Beispiel GOOS=windows GOARCH=amd64 go build ./cmd/agentiloop.

Die Tests greifen nicht aufs Netzwerk zu. Die Agent-Schleife läuft gegen ein geskriptetes Fake-Modell und die Streaming-Parser gegen einen lokalen Testserver. Die TUI wird auf dem simulierten Bildschirm von tcell gezeichnet. Der MCP-Client wird gegen einen mitgelieferten Beispielserver über alle drei Verbindungsarten (stdio, HTTP, SSE) getestet. Du kannst diesen Server auch selbst starten, um MCP von Hand auszuprobieren:

go run ./examples/mcp-example-server --http 8791   # oder --sse 8792, oder --stdio

Wie der Code aufgebaut ist

Das Projekt ist in fünf Packages aufgeteilt, und jedes baut auf den vorherigen auf:

Package	Was drinsteckt
`core`	Das Herzstück: die Agent-Schleife, Nachrichten, die Tool- und Anbieter-Schnittstellen, Berechtigungen, Sitzungen, Zusammenfassungen
`provider`	Spricht mit den Modellen: Anthropic, OpenAI-kompatible Server, oMLX
`tools`	Eingebaute Tools: `read_file`, `write_file`, `edit_file`, `list_dir`, `glob`, `grep`, `web_fetch`, `todo_write`, `bash`
`mcp`	Der MCP-Client, portiert von AgentMCP aus dem Swift-Code von Agent!
`cmd/agentiloop`	Das Programm `agentiloop`: Optionen, Chat, TUI, Einstellungen

core, provider, tools und mcp verwenden nur die Go-Standardbibliothek und lassen sich deshalb in andere Programme einbetten.

Abhängigkeiten

Alles, was nicht zur TUI oder zur Kommandozeile gehört, nutzt die Standardbibliothek. Das Programm agentiloop fügt hinzu:

Modul	Wofür
`github.com/spf13/pflag`	Kommandozeilenoptionen
`github.com/peterh/liner`	Der zeilenweise Chat
`github.com/gdamore/tcell/v2`, `github.com/mattn/go-runewidth`	Die TUI
`github.com/yuin/goldmark`, `github.com/alecthomas/chroma/v2`	Markdown und Syntaxhervorhebung

Roadmap

Lizenz

PolyForm Noncommercial 1.0.0. Du darfst diese Software für persönliche und nichtkommerzielle Zwecke nutzen, ändern und weitergeben. Die kommerzielle Nutzung, einschließlich des Erstellens oder Verkaufens kommerzieller Versionen, ist AgentiLoop vorbehalten. Wende dich für eine kommerzielle Lizenz an AgentiLoop.

AgentiLoop: agentiloop.ai

Navigation Menu

Uh oh!

AgentiLoopGo

🎉 Wir haben Version v0.0.5 für Mac, Windows und Linux veröffentlicht!

💖 Unterstütze AgentiLoop

🚀 Neu hier? In 5 Minuten startklar

1. AgentiLoop herunterladen

2. Einen API-Schlüssel besorgen

3. Deine Einstellungen im Shell-Profil speichern

4. Prüfen, ob es funktioniert

5. Deine erste Sitzung

Was kann er? (Tools)

Der Hilfe-Befehl

Hängst du fest? Schnelle Lösungen

Schnellstart

Schritt 1: Installieren

Schritt 2: Ein Modell verbinden

Schritt 3: Starten

Drei Arten, es zu benutzen

Er merkt sich deine Einstellungen

Alle Optionen

Befehle im Chat

Lange Unterhaltungen

Projektanweisungen

Tools mit MCP hinzufügen (optional)

Wo alles gespeichert wird

Weitere Umgebungsvariablen

Für Entwickler

Bauen und testen

Wie der Code aufgebaut ist

Abhängigkeiten

Roadmap

Lizenz

Uh oh!

FilesExpand file tree

README_de.md

Latest commit

History

README_de.md

File metadata and controls

AgentiLoopGo

🎉 Wir haben Version v0.0.5 für Mac, Windows und Linux veröffentlicht!

💖 Unterstütze AgentiLoop

🚀 Neu hier? In 5 Minuten startklar

1. AgentiLoop herunterladen

2. Einen API-Schlüssel besorgen

3. Deine Einstellungen im Shell-Profil speichern

4. Prüfen, ob es funktioniert

5. Deine erste Sitzung

Was kann er? (Tools)

Der Hilfe-Befehl

Hängst du fest? Schnelle Lösungen

Schnellstart

Schritt 1: Installieren

Schritt 2: Ein Modell verbinden

Schritt 3: Starten

Drei Arten, es zu benutzen

Er merkt sich deine Einstellungen

Alle Optionen

Befehle im Chat

Lange Unterhaltungen

Projektanweisungen

Tools mit MCP hinzufügen (optional)

Wo alles gespeichert wird

Weitere Umgebungsvariablen

Für Entwickler

Bauen und testen

Wie der Code aufgebaut ist

Abhängigkeiten

Roadmap

Lizenz