Doku

Erste Schritte

Installieren Sie srooterctl und den Coding-Agenten mit einem einzigen Befehl und melden Sie sich dann an. login öffnet einen Browser, um den Rechner freizugeben, der seinen eigenen Schlüssel erhält (die Freigabe ist in jedem Browser möglich, funktioniert also auch über SSH). Für das Coding wird Node.js 20 oder neuer benötigt.

curl -fsSL https://api.palgu.ai/install.sh | bash
srooterctl login                     # approve in your browser
srooterctl                           # coding session in this directory
srooterctl -p "fix the failing test" # one task, then exit

irm https://api.palgu.ai/install.ps1 | iex       # PowerShell, no admin rights
srooterctl login                     # approve in your browser
srooterctl                           # coding session in this directory
srooterctl -p "fix the failing test" # one task, then exit

Neu hier? Registrieren Sie sich zuerst (per Einmalcode an Ihre E-Mail; dabei wird Ihre Organisation erstellt). Auf der Download-Seite finden Sie Studio auch für Mac und Windows.

Optional: Claude Code oder Codex über Palgu routen

srooterctl ändert Claude Code oder Codex nur, wenn Sie es explizit anfordern. enable zeigt die genaue Konfigurationsänderung an, bevor sie geschrieben wird, und ein erneutes Ausführen ändert nichts.

srooterctl enable claude    # Claude Code, via ~/.claude/settings.json
srooterctl enable codex     # Codex, via ~/.codex/config.toml
curl -fsSL https://api.palgu.ai/install.sh | bash -s -- --with-claude-codex   # both, at install

Weitere Tools

Das Gateway bietet zwei Endpunkte: nativ für Anthropic unter /anthropic/v1/messages und OpenAI-kompatibel unter /v1/chat/completions. Verbinden Sie ein Tool mithilfe eines srt_-Schlüssels aus dem Dashboard mit einem dieser Endpunkte. Vollständige Einrichtung: Claude Code, Codex und weitere Tools.

Tools im Anthropic-Format

ANTHROPIC_BASE_URL=https://api.palgu.ai/anthropic
ANTHROPIC_API_KEY=srt_xxx_yyy

aider / OpenAI-kompatible Clients

OPENAI_BASE_URL=https://api.palgu.ai/v1
OPENAI_API_KEY=srt_xxx_yyy

Claude Code, Codex und andere Tools

Der einfachste Weg ist srooterctl login und anschließend srooterctl enable claude oder srooterctl enable codex. Dabei wird der Schlüssel wiederverwendet, den srooterctl für diesen Rechner gespeichert hat. Ein API-Schlüssel aus dem Dashboard wird nur benötigt, wenn Sie ein Tool manuell einbinden oder direkte API-Aufrufe tätigen.

Wie enable die einzelnen Clients anbindet

Claude Code läuft über die Edge von Palgu (sicher für Prompts, die Code enthalten), fest eingetragen in ~/.claude/settings.json, was Claude Code bei jeder Sitzung liest, einschließlich --continue und IDE-Starts. Codex erhält einen srooter-Provider in ~/.codex/config.toml: Es ignoriert OPENAI_BASE_URL, sodass Umgebungsvariablen allein Ihren Schlüssel an OpenAI senden und mit Fehler 401 scheitern würden. Starten Sie offene Sitzungen nach der Aktivierung neu. Sie möchten eine laufende Sitzung übernehmen? srooterctl --continue-claude (oder --continue-codex) nimmt sie in diesem Ordner wieder auf.

Claude Code manuell einbinden

Fügen Sie einen env-Block zu ~/.claude/settings.json hinzu. Dadurch wird die Edge umgangen, sodass Anfragen, deren Prompts Code enthalten, von der Hosting-Firewall blockiert werden können. Nutzen Sie vorzugsweise srooterctl enable claude.

ANTHROPIC_BASE_URL=https://api.palgu.ai/anthropic
ANTHROPIC_API_KEY=<your key>

Codex manuell einbinden

In ~/.codex/config.toml einfügen (Top-Level-Schlüssel vor jedem [section]-Block), bei gesetztem SROOTER_API_KEY. Eine Warnung wie Model metadata for 'glm-5.3' not found ist harmlos. Auch hierbei wird die Edge umgangen.

model = "glm-5.3"
model_provider = "srooter"

[model_providers.srooter]
name = "srooter"
base_url = "https://api.palgu.ai/v1"
env_key = "SROOTER_API_KEY"
wire_api = "responses"

Eine einzelne Sitzung routen oder Routing beenden

srooterctl shell            # routes only this session; exit to leave
srooterctl disable          # new terminals stop routing through Palgu
srooterctl claude-env off   # Claude Code stops routing through Palgu
eval "$(srooterctl on)"     # route this shell in place (off: restore)

Ein schneller API-Check

Ersetzen Sie das Modell durch eines, das Ihre Organisation aktiviert hat.

source ~/.srooter/config   # loads SROOTER_API_KEY (saved by srooterctl)
curl https://api.palgu.ai/v1/chat/completions \
  -H "Authorization: Bearer $SROOTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<your-model>","messages":[{"role":"user","content":"hello"}]}'

Weitere Tools

Cline, Roo Code, Kilo Code, Continue, Cursor, Zed, OpenHands und OpenCode: Provider OpenAI Compatible, Basis-URL https://api.palgu.ai/v1 und Ihr srt_-Schlüssel in den Einstellungen des Tools (nicht in einer Datei, die Sie committen). aider:

source ~/.srooter/config   # loads SROOTER_API_KEY (saved by srooterctl)
export OPENAI_API_BASE='https://api.palgu.ai/v1'
export OPENAI_API_KEY="$SROOTER_API_KEY"
aider --model openai/deepseek-pro

Vor Palgu noch nicht unterstützt: Windsurf, Gemini CLI und Antigravity. Palgu kann diese Modelle jedoch bereits als Backends bereitstellen.

Fehlerbehebung: Eine Sitzung läuft nicht über Palgu

Symptome: Der Agent beschreibt Änderungen nur, statt sie vorzunehmen, Ihr Audit-Log zeigt wenig oder gar keinen Traffic oder Ihre Richtlinien greifen nicht. Führen Sie in diesem Terminal srooterctl doctor aus: Es zeigt genau an, was fehlgeschlagen ist.

• Claude Code: installed, NOT routed through Palgu: führen Sie srooterctl enable claude aus und starten Sie dann die Sitzung neu.
• gateway probe: FAIL (401): Ihr Schlüssel ist ungültig oder abgelaufen. Führen Sie srooterctl login erneut aus oder fügen Sie mit srooterctl repair --key-stdin (verdeckte Eingabe) einen neuen Schlüssel ein.
• Ein lokaler Model-Routing-Wrapper, der das Coding an eine andere CLI übergibt, konkurriert mit Palgu: Schalten Sie ihn in diesem Repository aus.

Neuigkeiten

Palgu Studio, die Desktop-App

palgu> Studio ist eine macOS-App für die Programmierung über Palgu. Sie erfordert keine Änderungen an der Umgebung, führt standardmäßig TDD mit funktionaler und visueller Validierung aus und stellt dem Agenten Ihren Code-Graphen als Projektkontext bereit. Jede Anfrage läuft über das Gateway (Routing, Budgets, Richtlinien, Audit). Signiert und notarisiert, für Apple Silicon und Intel.

Alles in einem Fenster

• Tasks wählen Sie ein Projekt und beschreiben Sie Ihr Ziel; ein Agent bearbeitet die Aufgabe im Live-Chat, überträgt seinen Fortschritt in Echtzeit und fragt vor Schreib- und Shell-Aktionen nach. Führen Sie mehrere Aufgaben parallel aus (im gemeinsamen Verzeichnisbaum oder im isolierten Worktree).
• Sessions Ihre vergangenen Agenten-Sitzungen, gruppiert nach Tag; setzen Sie eine Sitzung genau dort fort, wo sie beendet wurde.
• Knowledge der Cortex-Code-Graph plus Mnemos-Sitzungsprotokolle. Der Graph wird beim Öffnen eines Projekts indexiert, sodass der Agent direkt mit einer Karte des Codes startet. Aktualisieren Sie hier auch die Agent Codemap.
• Council fünf Modelle prüfen eine Änderung anhand von SOLID, C4, OWASP und der Testpyramide. Sie sehen deren Befunde und Abweichungen und können einen Befund anfechten.
• Reviews fügen Sie einen Link zu einem GitHub Pull Request ein (oder prüfen Sie Ihren lokalen Diff) für ein fundiertes Review durch das Gremium.
• Routing sehen Sie, an welches Modell jede Stufe weiterleitet und warum (schreibgeschützt; Bearbeitung im Web-Dashboard).

Neu hier? Laden Sie Studio oder die CLIs herunter und melden Sie sich an: Die Einführung direkt in der App begleitet Sie durch Ihre erste Aufgabe.

Das Coding-CLI srooterctl

Führen Sie srooterctl aus, um eine Coding-Sitzung in Ihrem Projekt zu starten, oder srooterctl -p "…", um eine einzelne Aufgabe auszuführen und das Programm zu beenden. Es ersetzt claude oder codex in Ihrem Workflow. Der Coding-Agent kommuniziert ausschließlich mit Ihrem Palgu-Gateway, sodass Routing, Budgets, Richtlinien, Audit und Cortex für jede Anfrage gelten. srooterctl prüft den Agenten vor jedem Start gegen ein signiertes Release, und srooterctl update aktualisiert ihn.

srooterctl                           # interactive session in this directory
srooterctl -p "summarize src/index.ts"   # one task, then exit (CI-friendly)
srooterctl --continue                # continue your last session (--resume <id> for one)
srooterctl --continue-claude         # pick up a Claude Code session (--continue-codex: Codex)
srooterctl code [--] <args…>          # pass any other agent flag through unchanged
srooterctl review [base] [--yes]     # council review; exit 0 approve, 1 changes requested
srooterctl doctor                    # check the agent, clients and your key

Unbekannte Wörter werden niemals als Prompt interpretiert: srooterctl fix the test bricht ab und schlägt srooterctl code -p "fix the test" vor. Der Befehl srooter-agent funktioniert weiterhin und startet über srooterctl. Einstellungen werden zuerst aus Flags gelesen, dann aus Umgebungsvariablen (SROOTER_URL, SROOTER_MODEL und SROOTER_PROJECT für das zugrunde liegende Cortex-Projekt) und schließlich aus ~/.srooter/config, die von login geschrieben wird.

Berechtigungen: Lese-Tools werden immer ausgeführt; Schreib- und Shell-Tools fragen in einer Sitzung nach einer Freigabe ([y] einmalig, [a] immer, [n] ablehnen). Bei nicht-interaktiven Läufen werden sie abgelehnt, sofern Sie nicht --dangerously-allow-all übergeben.

Befehlsreferenz

Slash-Befehle (in einer Sitzung)

Flags (nach srooterctl code)

Autonomie und Orchestrierung

• /loop <task> führt eine Aufgabe autonom aus. Nach jedem Durchgang entscheidet der Gateway-Heartbeat, ob der Agent vorzeitig gestoppt hat und weitermachen sollte, und speist seinen Impuls als nächsten Durchgang ein. Das Gateway setzt ein Budget pro Sitzung und ein Limit von 25 Iterationen durch.
• Sub-Agenten das Modell kann run_subagent aufrufen, um eine gezielte Teilaufgabe an einen neuen untergeordneten Agenten zu delegieren: eigener Kontext, dieselben Tools, eine Verschachtelungsebene (keine Rekursion). Der Sub-Agent ist nicht-interaktiv, sodass Tools mit Seiteneffekten nur ausgeführt werden, wenn der übergeordnete Agent die Freigabe für alles erteilt hat. Nutzen Sie Sub-Agenten für gezielte Recherchen oder unabhängige Aufgaben.
• MCP (standardmäßig aktiv) konfigurieren Sie Server in ~/.srooter/mcp.json (Benutzer) und .mcp.json (Projekt). Deren Tools werden automatisch als server__tool geladen und sind wie jedes Schreib-Tool durch Berechtigungen geschützt. Ein fehlerhafter Server wird protokolliert und übersprungen, führt aber nie zum Abbruch.

Betrieb, Planung und Workflows

srooterctl code monitor            # sessions, token totals, spend, scheduled count
srooterctl code schedule           # fire any due scheduled tasks once (cron tick)
srooterctl code schedule run       # foreground scheduler: tick every minute
srooterctl code workflow wf.json   # run a multi-step workflow

• /schedule add <m h dom mon dow> :: <prompt> · list · rm <id>. Gespeichert in ~/.srooter/agent/schedule.json; Ausführung mit schedule (einzelner Durchlauf, für System-Cron) oder schedule run (im Vordergrund).
• /workflow <file> eine JSON-Datei mit Schritten { name, steps: [{ id, prompt, dependsOn? }] }. Schritte laufen in Reihenfolge ihrer Abhängigkeiten (unabhängige Schritte einer Ebene laufen parallel); ein Schritt-Prompt kann mit {{stepId}} auf die Ausgabe eines früheren Schritts verweisen. Jeder Schritt läuft als Sub-Agent.

Cortex und Review

• Cortex das Modell kann ein search_cortex-Tool aufrufen, das den Code-Graphen Ihrer Organisation über das Gateway abfragt. So stützt es sich auf echte Symbole statt nur auf lokales grep. /cortex <query> führt die Abfrage direkt aus. Erfordert ein indexiertes Projekt (SROOTER_PROJECT).
• Review srooterctl review [base] oder /review in einer Sitzung sendet Ihren committeten Branch (ab dem Merge-Base mit origin/<default branch> oder der angegebenen Basis) an das Multi-Modell-Review-Gremium des Gateways und gibt das Urteil samt file:line-Befunden aus. Vor dem Senden werden Dateien und Byte-Anzahl aufgelistet und Ihre Bestätigung eingeholt. Dateien mit .env*, *.pem, *.key, *secret* und id_rsa* werden niemals gesendet, und der Diff ist auf 120.000 Zeichen begrenzt. Das Gremium liest den Diff; es führt Ihren Code nicht aus. Siehe Palgu Review.

Routing-Regeln

Palgu stuft jede Anfrage in eine Stufe (Tier) ein und routet sie an das dieser Stufe zugewiesene Modell. Die Zuweisungen konfigurieren Sie in Ihrem Dashboard. Standardwerte:

Ändern Sie diese in Ihrem Dashboard unter Routing & Flow: Wählen Sie das Modell pro Stufe, das Modell für die Intent-Klassifizierung, die Council-Mitglieder und den Schwellenwert für langen Kontext. Eine Live-Vorschau bewertet Ihre Konfiguration nach Geschwindigkeit, Kosten und Qualität sowie den gemischten $/1k Token, inklusive eines Basisvergleichs mit dem Einsatz eines einzigen Frontier-Modells für alles. Änderungen gelten für neue Anfragen; Sie können jederzeit auf die Palgu-Standardwerte zurücksetzen. Feste Obergrenzen (Modell-Allowlists, maximaler Reasoning-Aufwand, Geschwindigkeitsstufe) finden Sie unter Policies.

Cortex-Code-Graph

Cortex ist ein iCPG (intelligenter Code-Property-Graph), das Wissen Ihrer Organisation über den eigenen Code: Symbole, Abhängigkeitskanten und aus Docstrings extrahierter Intent. Sobald ein Repository indexiert ist, beantworten Coding-Sitzungen Fragen wie „Wo ist X?“ direkt aus dem Graphen, und Coding-Sitzungen sowie Risiko-Reviews nutzen ihn, um zu erkennen, was eine Änderung berührt.

srooter ist die Cortex-CLI von Palgu, die install.sh neben srooterctl einrichtet.

srooter cortex build .         # index this repo (project auto-detected)
srooterctl cortex .            # same, using your saved key + gateway
srooter cortex build . --force # force a re-index
srooterctl cortex-hook on      # auto-index on every Claude Code session
srooterctl doctor             # verify ("cortex auto-index: OK")

Durchsuchen Sie ihn in Ihrem Dashboard unter Cortex: Suche über Code, Intent und Memory hinweg, eine geclusterte Graphenansicht, Statistiken sowie die aus Ihrem Code erfassten Intent-Knoten (Ziele, Invarianten, Entscheidungen).

Agenten-Codemap

Eine CODEMAP.md ist eine maschinenoptimierte Karte, die ein KI-Agent zuerst liest, um sich in einem Repository zu orientieren: was das System ist, wo was liegt, wie eine Anfrage fließt und welche Invarianten nicht verletzt werden dürfen, anstatt Dutzende Tool-Aufrufe für das Durchsuchen des Verzeichnisbaums zu verbrauchen. Wo AGENTS.md und CLAUDE.md dem Agenten die Regeln vorgeben, liefert ihm die Codemap die Karte. Palgu generiert sie aus Ihrem Code-Graphen, und --check meldet eine veraltete Karte. Es ist reines Markdown, sodass jeder Agent sie lesen kann (Claude Code, Codex, Cursor, Windsurf, OpenCode).

srooter cortex codemap .           # preview a fresh map (stdout)
srooter cortex codemap . --write   # write / refresh CODEMAP.md
srooter cortex codemap . --check   # validate anchors + freshness (exit 1 on error)
srooterctl codemap .               # same, using your saved key
# also: /codemap in a srooterctl session, Studio Knowledge Refresh CODEMAP.md

Der Generator verwaltet die deterministischen Abschnitte (Architektur, Modulübersicht, Gefahrenzonen) und entwirft den Rest mit Konfidenzmarkierungen, die Sie kuratieren können. --check sichert Schreibvorgänge ab und läuft beim Sitzungsstart, sodass eine veraltete oder fehlerhafte Übersicht erkannt und niemals blind übernommen wird. Siehe ADR-067.

Skills

Skills bringen Ihre Engineering-Praktiken je nach Vorhaben in das Modell ein. Palgu liefert vier Standard-Skills mit:

Skill-basiertes Routing: Für Einzelaufgaben wie eine Präsentation, ein Dashboard, eine Landingpage oder ein ausgefeiltes Dokument kann das Routing einen passenden Skill hinzufügen und das Modell für diese Anfrage hochstufen. Definieren Sie eigene organisationsweite Skills (Name, Anweisung, Absichten, weiche oder strikte Durchsetzung, Priorität) unter Standards & Skills sowie persönliche Skills, die auf der Organisationsrichtlinie aufbauen, aber niemals die Governance überschreiben, unter Meine Skills.

Sitzungsspeicher

Mnemos ist das Arbeitsgedächtnis von Palgu pro Coding-Sitzung. Bei Datenverkehr im Anthropic-Format zeichnet es die Eingangsfrage der Sitzung, die bearbeiteten oder geschriebenen Dateien sowie Tool-Fehler auf und speichert diese als Checkpoints, wenn die Sitzung länger wird. Aktuell dient es als Protokoll zur Einsichtnahme: Sein Inhalt wird nicht wieder in die Anfragen Ihrer Agenten eingespeist.

Prüfen Sie es in Ihrem Dashboard unter Sessions → Memory: Sitzungen mit ihrem letzten Checkpoint (Ziel, aktive Einschränkungen, ein Ermüdungswert) und die typisierten Knoten (Goal · Constraint · Error · Decision · Result).

Risikoprüfungen

Risikoprüfungen fangen Änderungen ab, die sensible Bereiche betreffen: Authentifizierung, Mandantenabgrenzung, Secrets. Ein schnelles Guard-Modell bewertet jede Änderung parallel im Hintergrund; ist der Wert hoch, prüft ein Frontier-Reviewer-Modell (claude-opus) den Ansatz und gibt dem Agenten im nächsten Schritt Korrekturempfehlungen mit. Risikoprüfungen blockieren die Entwickler nicht.

Prüfen Sie Ereignisse in Ihrem Dashboard unter Risk: Jedes zeigt den Schweregrad, die Befunde (welche Dimensionen ausgelöst haben, samt Belegen), die Korrekturempfehlung sowie Schaltflächen zum Markieren des Ergebnisses (confirmed / incident / dismissed / trivial), damit sich der Schwellenwert auf Ihre Codebasis einstellt.