grok-bot
17a2bc8a45
Add reader vorlagen (permissions, MCP, hooks, plugins, team AGENTS), humanizer skill, and adaptionen for ki-codex; refresh chapters 00–18, resource-path justfile, and dist PDF with full illustration set.
9.6 KiB
Vorwort
Warum dieses Buch – und wie du es liest
Kern in einem Satz: Grok Build ist kein Chatfenster mit Terminal-Ambiente, sondern ein agentischer Harness um ein Sprachmodell: Es liest Code, plant, ruft Werkzeuge auf, wartet auf deine Freigaben und schreibt Änderungen – und genau diese Schleife musst du beherrschen, um produktiv und sicher zu arbeiten.
Für wen dieses Buch ist
Du arbeitest mit Code im Terminal (oder lernst das parallel mit dem Buch-Übungsprojekt). Coding-Agenten können neu für dich sein – das ist der Normalfall für den Einstiegspfad, nicht die Ausnahme. Zielgruppe:
- Professionelle Entwickler und Juniors, die Features, Fixes und Refactors im Repo erledigen – nicht nur „eine Funktion erklären lassen“
- Tech-Leads, die Standards setzen wollen (
AGENTS.md, Permissions, CI) und dem Team einen gemeinsamen Workflow geben - Power-User, die Plan Mode, Subagents, Worktrees, Headless und MCP nicht nur kennen, sondern steuern
Du brauchst keinen Informatik-Abschluss und musst kein Tech-Lead sein. Terminal und ein kleines Repo reichen als Startbasis; Kapitel 2 holt die ersten Git-/Diff-Muskeln nach.
Was du hier nicht findest: Marketing-Versprechen, „10x productivity“-Rhetorik und Kapitel, die nur die offizielle Flag-Liste abtippen. Die Doku listet Optionen. Dieses Buch erklärt wann du welchen Hebel ziehst und welche Fehlerklasse du damit vermeidest.
Was du in diesem Buch lernst
Grok Build (CLI: grok) ist der Coding-Agent von xAI (Auth-Oberfläche und OAuth: oft als SpaceXAI sichtbar). Er läuft vor allem als interaktive TUI im Terminal, als Headless-Lauf für Scripts und CI, und als ACP-Server für IDEs und eigene Clients. Überall sitzt dieselbe Engine: ein Modell plus eine Steuerungsschicht aus Tools, Permissions, Memory und Workflows.
Wie das Lernen hier aufgebaut ist: Zuerst baust du ein mentales Modell (Kapitel 1), dann installierst und übst du risikolos (Kapitel 2–3), dann kommen die Produktivitäts-Hebel (Plan Mode, Subagents, Worktrees, AGENTS.md). Erst danach Automation, Erweiterungen und der große Use-Case-Block – weil sie ohne Grundlagen schwer zu debuggen sind.
Dieses Buch führt dich stufenweise:
- Einstieg – Lesevertrag, Harness-Mentalmodell, Surfaces
- Setup & TUI – Installation, Auth, Alltag in der Oberfläche
- Kern-Workflows – Plan Mode, Subagents, Worktrees, Projektregeln
- Erweiterbarkeit – Skills, Plugins, Hooks, MCP
- Automation – Headless, CI, ACP/IDE
- Steuerung – Memory, Permissions, Sandbox, Config
- Praxis & Nachschlagen – Use-Cases, Best Practices, Vergleich, Cheatsheets
Du darfst springen. Querverweise greifen, ohne dass du alles linear gelesen haben musst.
{width=80%}
Anfänger-Lesepfad (erste Session ~90–120 Min., dann Woche 1)
Wenn Grok Build und agentisches Arbeiten neu für dich sind, nimm diesen Minimum-Pfad – nicht das ganze Inhaltsverzeichnis am Tag 1. Day-1 meint hier die erste Lernsession (Install bis TUI-Grundlagen), nicht „alles an einem Kalendertag“. Die Zeiten sind grob; Auth-Probleme und Neugier fressen Puffer – das ist normal.
| Zeit | Was | Erfolg |
|---|---|---|
| ~45–60 Min. | Vorwort skimmen → Kapitel 1 skimmen (Kern + Mini-Glossar 1.11 merken, Rest bei Bedarf) → Kapitel 2 (Install + 15-Min-Parcours mit beispiele/todo-cli) |
grok läuft; ein Read-only-Turn; ein gelesener Diff |
| ~30–45 Min. | Kapitel 3 nur Day-1-Cockpit (Fokus, Abbruch, Modes, Sessions 1–2) + Parcours-Pflichtteil | Mode Normal erkannt; einmal bewusst abgebrochen |
| Diese Woche | Kapitel 4 (Plan Mode) + Kapitel 7 minimal (AGENTS.md); optional Use-Case-Variante in 15.2 (todo-cli) |
Ein Plan kommentiert oder freigegeben |
| Später | 05–06, 08–14 nach Bedarf; weitere Use-Cases in 15; Symptom→Fix in 16 | Wenn der Alltag es verlangt |
Tag 1 / Day-1 brauchst du nicht: Subagents, Worktrees, MCP, Headless, Always-approve/YOLO, Custom Models. Die multiplizieren Fehler, bevor Scope und Review sitzen.
Standard-Übungsrepo: beispiele/todo-cli/ – Mini-Python-CLI im Buch-Repo (Kapitel 2–4). Eigenes Side-Projekt geht auch.
Steckst du fest? Zuerst die Fehlertabelle in Kapitel 2.12, danach Symptom→Fix in Kapitel 16.6.
Warum dieses Buch und nicht nur die Doku? Die offizielle Hilfe und der User-Guide listen Commands und Pfade. Dieses Buch erklärt die Arbeitsarchitektur: welche Schicht was steuert, welche Fehlerklasse eine Config vermeidet, und in welcher Reihenfolge du die Knöpfe drehst, ohne dich zu überfordern. 70–75 % der Seiten sind Praxis: Sessions, Prompts, Checklisten, Fallstricke.
Wie dieses Buch aufgebaut ist
Jedes größere Kapitel endet mit:
- Was du jetzt kannst – prüfbare Fähigkeiten
- Nächste Schritte – wohin blättern
Größere Abschnitte ergänzen:
- Checkliste
- Häufige Fehler
- So baust du das in deinem Projekt nach
Im PDF erkennst du drei Callout-Kästen am linken Farbbalken und einem kleinen Icon:
| Kasten | Bedeutung | Wann du handelst |
|---|---|---|
| Kern (navy) | Die eine Aussage, die der Abschnitt tragen muss | Merken / als Kompass nutzen |
| Jetzt selbst machen (teal) | Übung – Terminal auf, nachtippen | Aktiv ausführen, nicht nur lesen |
| Achtung (burgundy) | Echtes Risiko (Secrets, Prod, Always-approve, destruktive Shell) | Vor dem nächsten Schritt anhalten |
Passives Lesen reicht bei Jetzt selbst machen nicht – agentische Tools lernt man nur mit Feedbackschleife (Prompt → Tool → Diff → dein Urteil). Warum-/Wie-Absätze und Checklisten bleiben normaler Fließtext: absichtlich ohne Icon-Flut.
Weitere Gerüste und Vorlagen: beispiele/, vorlagen/ – von Anfang an kopierfähig. Das Day-1-Übungsrepo ist oben im Anfänger-Lesepfad verlinkt.
Lesevertrag: Dieses Buch erklärt stabile Konzepte (Harness, Plan Mode, Subagents, Memory vs. Config, Explore–Plan–Code–Verify). Einzelne Slash-Command-Labels und TOML-Felder können mit Releases driften. Im Zweifel gelten grok --version, die eingebaute Hilfe und der User-Guide unter ~/.grok/docs/user-guide/.
Haltung
Der Ton ist der eines erfahrenen Kollegen: präzise, geduldig, ohne Hype. Wenn etwas riskant ist, steht das da. Wenn eine Config eine Fehlerklasse vermeidet, erklären wir welche und wie.
Ein Nachmittag, den du vermeiden willst: Du klebst einen Stacktrace in die TUI, akzeptierst drei Diffs ohne Lesen, committest „fix stuff“ – und merkst erst im Review, dass .env.example mit echten Keys und ein rm im falschen Ordner im Diff lagen. Das Buch trainiert die Gegenbewegung: Scope formulieren, Freigaben lesen, Diffs prüfen, Wissen in Dateien legen (AGENTS.md, Plan-Datei, Skills) statt nur im Chat. Nicht weil KI böse ist – weil der Harness ausführt, was das Modell vorschlägt.
Versionshinweis: Features und Slash-Commands entwickeln sich. Konzepte (Permissions, Memory, Tools, Sessions) bleiben stabiler als einzelne UI-Labels. Stand der Fakten im Buch: Juli–Aug 2026 (CLI 0.2.x).
Was dieses Buch nicht ist
- Keine offizielle xAI-Dokumentation – Produktnamen gehören den Rechteinhabern; bei Abweichungen gilt die aktuelle Hersteller-Doku.
- Kein Ersatz für Review und Ownership – du bleibst verantwortlich für Merge und Produktion.
- Kein Modell-Trainingshandbuch – wir steuern den Harness; Modellwahl ist ein Hebel unter vielen (Kapitel 14).
- Kein reines Feature-Inventar – wenn ein Feature die Nutzung nicht verbessert, bekommt es keinen eigenen Exkurs.
Voraussetzungen in einem Blick
Für den vollen Praxisnutzen brauchst du:
- macOS, Linux oder Windows (nativ / Git Bash / WSL – Details in Kapitel 2)
- Internetzugang für Auth und Modellaufrufe
- Ein Konto bzw. API-Zugang, der Grok Build freischaltet (Browser-Login über grok.com oder
XAI_API_KEY– Kapitel 2) - Ein bekanntes Übungsrepo – Standard im Buch:
beispiele/todo-cli/(Kapitel 2); alternativ ein eigenes Side-Projekt (nicht Produktion, nicht der Downloads-Ordner mit dem fremden ZIP)
Hardware-Richtwerte hängen vom Host und vom Modell ab; praxisnah reichen moderne Laptops mit genug RAM für Editor, Terminal und Build deines Projekts.
Wie du prüfst, ob du startklar bist: Nach der Installation grok --version (Kapitel 2). Danach trennt du „Binary/PATH“ von „Login/Key“ – spart 20 Minuten Rätselraten.
Harness, nicht Zauberei
Ab hier geht es um die Werkbank: Plan Mode, Permissions, AGENTS.md, Subagents und Grenzen. Das Modell liefert Vorschläge – der Harness macht daraus steuerbare Arbeit.
{width=55%}
Was du jetzt kannst
- Einordnen, für wen dieses Buch geschrieben ist und welchen Praxis-Anteil es verspricht
- Die drei Callout-Typen (Kern, Jetzt selbst machen, Achtung) und den Kapitel-Rhythmus erklären
- Den Anfänger-Lesepfad (Day-1 + Woche 1) und das Standard-Übungsrepo
beispiele/todo-clibenennen
Nächste Schritte
→ Kapitel 01 – Einführung und Philosophie: Modell vs. Harness, Surfaces und das mentale Modell für alles Weitere. Anschließend Kapitel 2 mit todo-cli.