Grok Build
Pracovní reference k terminálovému coding agentovi xAI: příkazy, oprávnění, hooks, MCP, sandbox a automatizace.
Instalace
curl -fsSL https://x.ai/cli/install.sh | bash
Spuštění
grok
Výchozí model
grok-4.6
Přepínání režimů
Shift+Tab
Konfigurace
~/.grok/config.toml
Instalace a první spuštění
| Příkaz | Co udělá |
|---|---|
curl -fsSL https://x.ai/cli/install.sh | bash | Instalace na macOS a Linuxu. |
irm https://x.ai/cli/install.ps1 | iex | Instalace na Windows (PowerShell). |
grok | Spustí interaktivní fullscreen TUI v aktuálním adresáři. |
grok --oauth | Přihlášení přes SpaceXAI OAuth na auth.x.ai. Je to výchozí chování, flag je nepovinný. |
grok --device-auth | Přihlášení device-code flow — pro headless a vzdálená prostředí. Alias --device-code. |
XAI_API_KEY=xai-… grok | Přihlášení API klíčem v prostředí bez prohlížeče. Klíč neukládej do repozitáře. |
grok agent stdio | Spustí agenta přes Agent Client Protocol (JSON-RPC) pro integraci do editoru či aplikace. |
/tutorial | Vestavěný onboarding: první prompt, přikládání kontextu, navigace, worktrees, plan mode. |
/doctor | Diagnostika terminálu, schránky, barev, vstupu, notifikací a sandboxu. |
Praktické recepty
Hotové výchozí vzory. Nahraď hodnoty v <…> a u automatizace ponech úzká oprávnění.
| Příkaz | Kdy ho použít |
|---|---|
grok | Interaktivní práce v aktuálním projektu. |
grok -p "Explain this codebase" | Jednorázové vysvětlení repozitáře. |
grok -c | Pokračování posledního sezení v aktuálním adresáři. |
grok -r <SESSION_ID> | Obnovení konkrétního sezení. |
grok -w <NAME> --ref <REF> | Izolovaná práce v novém git worktree. |
grok --sandbox read-only -p "Review this change" | Code review bez zápisu do projektu a bez sítě. |
grok inspect | Kontrola načtených pravidel, skillů, hooků a MCP. |
grok mcp add <NAME> -- <COMMAND> | Přidání lokálního MCP serveru přes stdio. |
grok -p "Run the tests" --max-turns 20 --no-auto-update | Ohraničený headless běh pro CI. |
grok -p "Deploy" --always-approve --deny 'Bash(rm -rf *)' | Automatizace s trvalým zákazem rizikového příkazu. |
CLI příkazy
| Příkaz | Co udělá |
|---|---|
grok login | Přihlášení; --device-auth použije device-code flow. |
grok logout | Odhlášení a odstranění uložených přihlašovacích údajů. |
grok inspect [--json] | Ukáže konfiguraci nalezenou pro aktuální adresář. |
grok models | Vypíše dostupné modely. |
grok mcp <list|add|remove|doctor> | Správa MCP serverů. |
grok plugin <COMMAND> | Instalace, aktualizace a správa pluginů. |
grok plugin marketplace <COMMAND> | Správa zdrojů marketplace. |
grok sessions <list|search|delete> | Správa uložených sezení. |
grok export <SESSION_ID> [OUTPUT] | Export sezení do Markdownu. |
grok import [TARGETS…] | Importuje sezení z Claude Code. |
grok memory clear [--workspace|--global|--all] | Vymaže zvolenou dlouhodobou paměť. |
grok worktree <list|show|rm|gc> | Správa worktrees vytvořených Grokem. |
grok dashboard | Otevře Agent Dashboard. |
grok wrap <COMMAND…> | Spustí příkaz v lokálním PTY s podporou schránky OSC 52. |
grok update [--check] | Zkontroluje nebo nainstaluje aktualizaci. |
grok version | Vypíše verzi. |
grok completions <SHELL> | Vygeneruje doplňování pro shell. |
grok setup | Stáhne a nainstaluje spravovanou konfiguraci. |
grok agent stdio | Spustí ACP agenta přes stdin/stdout. |
CLI flagy
Flagy označené „headless only" fungují jen s -p. --allow, --deny a --effort fungují v TUI i headless.
| Flag | Význam |
|---|---|
-p, --single <PROMPT> | Pošle jeden prompt neinteraktivně (headless). Alternativy: --prompt-file, --prompt-json. |
-m, --model <MODEL> | Volba modelu, například grok-4.6. |
-c, --continue | Naváže na poslední sezení v aktuálním adresáři. |
-r, --resume [<ID>] | Obnoví sezení podle ID; bez ID vybere poslední sezení. |
-s, --session-id <ID> | Založí nové sezení s daným UUID. Neobnovuje — na to je -r nebo -c. |
--fork-session | S -r/-c odbočí do nového ID místo připisování do původního sezení. |
--output-format <FMT> | plain, json, streaming-json nebo streaming-messages-json. |
--always-approve | Bez interaktivních dotazů na oprávnění. Alias --yolo. |
--permission-mode <MODE> | Režim oprávnění; bypassPermissions zapne always-approve. |
--allow <RULE> | Pravidlo povolení s glob vzory. Lze opakovat. |
--deny <RULE> | Pravidlo zákazu s glob vzory. Lze opakovat. |
--sandbox <PROFILE> | Sandbox profil pro přístup k souborům a síti. |
--tools <TOOLS> | Allowlist vestavěných nástrojů, oddělené čárkou. Jen headless. |
--disallowed-tools <TOOLS> | Denylist vestavěných nástrojů. Jen headless. |
--max-turns <N> | Strop počtu agentických kol. Jen headless. |
--reasoning-effort <LEVEL> | Úroveň uvažování: none, minimal, low, medium, high, xhigh, max. Alias --effort. Model přijme jen úrovně, které nabízí. |
-w, --worktree [<NAME>] | Spustí sezení v novém git worktree. Základ určíš přes --ref. |
--ref <REF> | Větev, tag nebo commit, ze kterého se založí nový worktree. |
--agent <NAME> | Jméno agenta nebo cesta k definičnímu souboru. |
--no-subagents | Zakáže spouštění subagentů. |
--no-plan | Vypne plan mode. |
--disable-web-search | Vypne nástroje pro web search a fetch. |
--cwd <PATH> | Nastaví pracovní adresář. |
--no-alt-screen | Poběží inline, bez převzetí celé obrazovky. |
--no-auto-update | Vypne kontrolu aktualizací pro tohle sezení — v CI se hodí. Trvale: auto_update = false. |
--rules <TEXT> | Vlastní pravidla do systémového promptu. |
--system-prompt-override <TEXT> | Přepíše systémový prompt agenta. |
Slash příkazy
Začni otevřenou skupinou Nejdůležitější příkazy. Ostatní příkazy jsou sbalené podle účelu; hledání otevře jen skupiny se shodou. Skilly označené jako user-invocable se objeví jako další slash příkazy.
Nejdůležitější příkazy11
| Příkaz | Co dělá |
|---|---|
/new | Nové sezení, vyčistí konverzaci. Alias /clear. |
/resume | Výběr a načtení dřívějšího sezení z disku. |
/fork | Odbočí aktuální sezení do nového agenta s historií po tento bod. |
/rewind | Vrátí konverzaci na dřívější kolo a zahodí vše po něm. Alias /undo. |
/compact [context] | Zhustí historii a uvolní kontextové okno. Poznámkou řekneš, co zachovat. |
/context | Rozpad využití kontextového okna po kategoriích. |
/session-info | Detaily sezení: způsob přihlášení, model, počet kol, kontext. Aliasy /status, /info. |
/model <name> | Přepne model. Bere ID i zobrazované jméno, u reasoning modelů i úroveň effortu. Alias /m. |
/effort <level> | Nastaví úroveň uvažování aktuálního modelu: low, medium, high, xhigh. |
/plan | Vstoupí do plan mode — do schválení jde editovat jen soubor s plánem. |
/btw | Vsuvka pro agenta bez přerušení běžícího úkolu. |
Sezení a historie12
| Příkaz | Co dělá |
|---|---|
/sessions | Přepne, přejmenuje nebo zavře aktivní sezení. |
/dashboard | Agent Dashboard — živý přehled sezení: peek, reply, dispatch, pin, rename, stop, attach. |
/delete | Smaže historii sezení. Ptá se na potvrzení a nejdřív zastaví běžící úlohy. |
/rename | Přejmenuje sezení. Alias /title. |
/export | Vyexportuje konverzaci do souboru nebo schránky. |
/copy | Zkopíruje zdrojový markdown poslední odpovědi. S číslem N-tou poslední. |
/share | Nasdílí současné sezení pomocí URL. |
/find | Hledá v historii zobrazené konverzace. |
/transcript | Otevře celý přepis v programu z $PAGER. |
/quit | Ukončí aplikaci. Alias /exit. |
/home | Opustí sezení a vrátí se na uvítací obrazovku. Alias /welcome. |
/history | Fuzzy hledání ve vlastních promptech tohoto sezení. |
Režimy, vstup a vzhled10
| Příkaz | Co dělá |
|---|---|
/view-plan | Náhled uloženého plánu. Aliasy /show-plan, /plan-view. |
/auto | Přepíná auto mode — klasifikátor sám schvaluje bezpečné nástroje. |
/always-approve | Přepíná always-approve (YOLO). Spuštění režimu, ve kterém už jsi, ho zase vypne. |
/multiline | Víceřádkový vstup: Enter odřádkuje, Shift+Enter odešle. |
/edit-prompt | Otevře prompt v externím editoru ($VISUAL, pak $EDITOR, pak vi). |
/compact-mode | Hustší rozvržení, méně odsazení. |
/vim-mode | Vimové klávesy ve scrollbacku (j/k, g/G, y…). |
/minimal | Přepne do experimentálního scrollback režimu. Zpět přes /fullscreen. |
/timestamps | Zapne nebo vypne časové značky u zpráv. |
/theme | Přepne barevné téma. Alias /t. |
Paměť a agenti7
| Příkaz | Co dělá |
|---|---|
/memory | Prochází a spravuje paměť. on/off ji zapne nebo vypne. Alias /mem. |
/remember <note> | Uloží poznámku do paměti ihned, bez čekání na automatický souhrn. |
/flush | Zapíše znalosti sezení do paměti hned — vhodné před kompakcí. |
/dream | Konsolidace paměti: sloučí logy sezení do uspořádaných témat. |
/config-agents | Správa definic agentů, nastavení výchozího a přepnutí aktivního. Alias /agents. |
/personas | Vytváření a úprava person. Subagent si personou tvaruje chování. |
/goal | Autonomní cíl napříč koly. Hotovo označí až po nezávislém přezkoumání důkazů. |
Úlohy, workflow a výzkum7
| Příkaz | Co dělá |
|---|---|
/tasks | Vypíše úlohy na pozadí, subagenty a naplánované úlohy. |
/queue | Vypíše prompty čekající za běžícím kolem. |
/deep-research <query> | Výzkum na pozadí: rozpad na otázky, sběr tvrzení s důkazy a křížová kontrola. |
/create-workflow [description] | Vytvoří a uloží nový workflow. |
/workflow | Spustí uložený workflow, nebo řídí běžící podle jeho jména. |
/workflows | Katalog nalezených workflows (vestavěné i projektové .grok/workflows/). |
/loop [interval] <prompt> | Opakuje prompt v intervalu — 30m, 1 hour, every 2 days. |
Rozšíření a integrace6
| Příkaz | Co dělá |
|---|---|
/hooks | Karta Hooks v modalu rozšíření: zobrazení, přidání, zapnutí a vypnutí hooků. |
/plugins | Karta Plugins: instalované pluginy, instalace z marketplace, správa důvěry. |
/marketplace | Karta Marketplace: procházení a instalace pluginů. |
/skills | Karta Skills: přehled nainstalovaných skillů. |
/mcps | Správa MCP serverů. |
/import-claude | Import z ~/.claude: oprávnění, env proměnné, MCP servery, hooks a cesty. |
Média2
| Příkaz | Co dělá |
|---|---|
/imagine <prompt> | Vygeneruje obrázek z textového popisu. |
/imagine-video <prompt> | Vygeneruje video: naplánuje záběry, vytvoří obrázky a rozhýbe je. |
Nápověda, účet a provoz11
| Příkaz | Co dělá |
|---|---|
/help | Přehled příkazů a klávesových zkratek. |
/settings | Interaktivní nastavení. Aliasy /config, /preferences, /prefs. |
/doctor | Kontrola terminálu, schránky, barev, vstupu, notifikací a sandboxu. |
/docs | Vestavěné návody nebo online dokumentace. Aliasy /howto, /guides. |
/tutorial | Onboarding tutoriál po tématech. |
/release-notes | Poznámky k vydání aktuální verze. Alias /changelog. |
/feedback [message] | Nahlásí problém nebo pošle zpětnou vazbu. Enter odešle, Esc zahodí. |
/login | Přihlášení nebo znovupřihlášení bez opuštění sezení. |
/logout | Odhlášení a návrat na přihlašovací obrazovku. |
/usage | Spotřeba kreditů a správa fakturace. Alias /cost. |
/privacy | Nastavení uchovávání dat a trénování na kódu. |
Režimy a oprávnění
Shift+Tab cykluje mezi režimy sezení. Účinek pravidla určuje jeho akce (deny > ask > allow), ne soubor, ze kterého pochází.
| Režim | Co projde bez dotazu | Kdy ho použít |
|---|---|---|
default | Read-only nástroje a vestavěné read-only shell příkazy. | Běžná interaktivní práce. |
acceptEdits | Úpravy souborů bez dotazu. | Lokální kódování, diffy kontroluješ později. |
auto | Co povolí bezpečnostní kontrola; zbytek se zablokuje nebo eskaluje. | Interaktivní sezení s menším počtem dotazů. |
dontAsk | Jen předschválené nástroje a read-only operace. | Přísné allowlisty v CI. |
bypassPermissions | Volání nástrojů obecně — deny pravidla, hooky a část shell ask pravidel platí dál. | Důvěryhodná automatizace a agent servery. |
plan | Přijímá se kvůli kompatibilitě; na hlídané plánování je plan mode. | Nastavení přenesená z Claude Code. |
Klávesové zkratky
| Zkratka | Akce |
|---|---|
Shift+Tab | Cykluje režimy sezení (plan → auto → always-approve). |
Ctrl+P | Paleta příkazů. Alternativa ?. |
Ctrl+M | Výběr modelu (ze scrollbacku). V promptu přepíná víceřádkový režim. |
Ctrl+O | Přepne always-approve (YOLO). |
Ctrl+N | Nové sezení — po druhém stisku vybereš normální nebo worktree. |
Ctrl+C | Přeruší běžící kolo. Když je v promptu rozepsaný text, nejdřív ho smaže. |
Ctrl+Q | Ukončí aplikaci. Ve VSCode Ctrl+D. |
Enter | Odešle prompt. Ve víceřádkovém režimu odřádkuje. |
Shift+Enter | Nový řádek. Alternativa Alt+Enter. |
Esc Esc | Do 800 ms: smaže rozepsaný prompt, u prázdného vrátí konverzaci zpět. |
Tab | Přepíná fokus mezi promptem a scrollbackem. |
Ctrl+J / Ctrl+K | Posun scrollbacku po řádcích. |
Ctrl+U / Ctrl+D | Posun o půl stránky. |
PgUp / PgDn | Posun po stránkách. |
Shift+←/→ | Ve scrollbacku skáče po kolech; v promptu vybírá znaky. |
Ctrl+V | Vloží text, soubory i snímky obrazovky (macOS a Linux). |
Alt+V | Vloží obrázek — jen Windows. |
Ctrl+E | Zobrazí uvažování modelu (ve vim režimu). |
j / k, g / G | Vim navigace ve scrollbacku: po řádcích, na začátek a konec. |
y / Y | Vim režim: zkopíruje obsah bloku / zkopíruje příkaz. |
Soubory a cesty
Projektové .grok/ se prohledává od aktuálního adresáře až ke kořeni repozitáře.
| Cesta | K čemu je |
|---|---|
~/.grok/config.toml | Hlavní konfigurace uživatele. |
.grok/config.toml | Konfigurace projektu, verzovatelná v repozitáři. |
~/.grok/auth.json | Přihlašovací tokeny. |
~/.grok/sessions/ | Uložená sezení. |
~/.grok/memory/ | Dlouhodobá paměť. |
~/.grok/skills/ · .grok/skills/ | Skilly uživatele a projektu. |
~/.grok/plugins/ · .grok/plugins/ | Pluginy; marketplace v ~/.grok/plugins/marketplaces/. |
~/.grok/hooks/ · .grok/hooks/ | Hook skripty. Projektové vyžadují /hooks-trust. |
~/.grok/agents/ · .grok/agents/ | Definice agentů a subagentů. |
~/.grok/workflows/ · .grok/workflows/ | Uložené workflows. |
.grok/personas/ | Persony pro subagenty. |
~/.grok/mcp_credentials.json | OAuth tokeny MCP serverů. |
~/.grok/logs/mcp/<server>.stderr.log | Chybový výstup MCP serveru. |
~/.grok/statusline.sh | Skript pro vlastní stavový řádek. |
AGENTS.md | Pravidla projektu. Podporuje i AGENT.md, hledá se až ke kořeni repozitáře. |
CLAUDE.md | Čte se kvůli kompatibilitě, včetně CLAUDE.local.md a .claude/rules/. |
Skilly
Skill je složka s SKILL.md, skripty a přílohami. Níž jsou pole frontmatteru. model, effort, license a compatibility Grok přijme, ale neaplikuje.
| Pole | Význam |
|---|---|
name | Identifikátor. Výchozí je jméno adresáře. |
description | Kdy skill použít. Výchozí je první odstavec těla. |
when-to-use | Další spouštěcí fráze. Přijímá se i when_to_use. |
paths | Gitignore globy — omezí, kde je skill viditelný. |
allowed-tools | Seznam povolených nástrojů (YAML pole nebo řetězec). |
argument-hint | Nápověda k argumentům při doplňování slash příkazu. |
user-invocable | Jen doslovné true udělá ze skillu slash příkaz. |
disable-model-invocation | Zabrání, aby si skill zavolal model sám. |
metadata | Mapa řetězců; author a short-description se zobrazují v UI. |
Hook události
Události se spouštějí ve třech kadencích: jednou za sezení, jednou za kolo a při každém volání nástroje. SubagentEnd je alias pro SubagentStop.
| Událost | Kdy nastane | Blokuje? |
|---|---|---|
SessionStart | Začátek sezení. U vlastního sezení subagenta se nespouští. | Ne |
UserPromptSubmit | Odeslal jsi prompt. | Ano — umí prompt zablokovat |
PreToolUse | Nástroj se chystá spustit. | Ano — umí zamítnout |
PostToolUse | Nástroj doběhl. | Ne, ale umí přepsat výstup, který uvidí model |
PostToolUseFailure | Nástroj se nepodařilo spustit, nebo MCP nástroj vrátil chybu. | Ne |
PermissionDenied | Systém oprávnění zamítl volání nástroje. | Ne |
Stop | Kolo agenta skončilo řádným dokončením. | Ano — umí zastavení zablokovat |
StopFailure | Kolo skončilo kvůli chybě API. | Ne |
StopCancelled | Místo Stop, když kolo nedoběhlo: přerušení, zamítnuté oprávnění, --max-turns. | Ne |
Notification | Události vyžadující pozornost (idle_prompt, permission_prompt, task_complete). | Ne |
SubagentStart | Subagent startuje. | Ne |
SubagentStop | Kolo subagenta skončilo. | Ano — umí zastavení zablokovat |
PreCompact | Chystá se kompakce konverzace. | Ne |
PostCompact | Kompakce doběhla. | Ne |
SessionEnd | Sezení končí. U potomka nese subagentType. | Ne |
MCP servery
| Příkaz / klíč | Význam |
|---|---|
grok mcp add <name> -- <cmd> | Přidá lokální stdio server. |
grok mcp add --transport http <name> <url> | Přidá vzdálený HTTP server. |
--header "Authorization: Bearer ${TOKEN}" | Hlavička pro autentizovaný endpoint. |
--scope project | Uloží server do konfigurace projektu, aby šel verzovat. |
grok mcp doctor | Diagnostika MCP serverů. |
${VAR} · ${VAR:-default} | Expanze proměnných v URL, příkazech, env i hlavičkách. |
[mcp_servers] | Definice serverů přímo v config.toml. |
startup_timeout_sec | Zvyš, když se balíčky serveru stahují pomalu. |
/mcps | Modal: Space přepne server, r obnoví, i přihlásí OAuth, a přidá, x odebere. |
Sandbox profily
Vlastní profil se odvozuje klíčem extends a zpřísňuje polem deny. Při jiném profilu než off se odmítne leader mode, aby nástroje zůstaly v procesu.
| Profil | Zápis | Síť | Pro co |
|---|---|---|---|
off | Bez omezení | Bez omezení | Výchozí — žádný sandbox. |
workspace | CWD + ~/.grok/ + /tmp + /var/tmp | Povolena | Běžný vývoj. |
devbox | Všechny kořenové adresáře kromě /data | Povolena | Jednorázové vývojové VM. |
read-only | ~/.grok/ + /tmp + /var/tmp | Blokována | Průzkum kódu a code review. |
strict | CWD + ~/.grok/sessions + /tmp + /var/tmp | Blokována | Nedůvěryhodný kód. |
Headless a CI
| Vzor | Význam |
|---|---|
grok -p "prompt" | Jeden prompt neinteraktivně. |
--output-format plain | Čitelný text — výchozí. |
--output-format json | Jeden JSON objekt na konci běhu. |
--output-format streaming-json | JSON události oddělené novým řádkem. |
--include-partial-messages | Surové stream_event delty; jen pro streaming-messages-json. |
-s <UUID> | Pojmenované headless sezení. Ukládá se do ~/.grok/sessions. |
--max-turns <N> | Pojistka proti nekonečnému běhu. |
--no-auto-update | V CI vypni kontrolu aktualizací na pozadí. |
grok agent stdio | ACP přes JSON-RPC pro integraci do editoru nebo aplikace. |
Novinky podle měsíce
Výběr pracovně významných funkcí z oficiálního changelogu Grok Build; opravy bez dopadu na způsob práce jsou vynechané.
| Měsíc | Co přibylo | Od verze |
|---|---|---|
| Srpen 2026 | Verze 1.0, dashboard se souhrny, workflows, plánované smyčky, stavový řádek, grok clone a rozšířené řízení oprávnění. | 1.0.0–1.0.13 |
| Červenec 2026 | Streaming JSON v headless režimu, /undo, /delete, /tutorial, správa MCP z CLI a obnovitelné workflow runs. | 0.2.112–0.2.118 |
| Květen 2026 | Veřejná beta Grok Build s interaktivním TUI, headless během a Agent Client Protocol; následoval coding model grok-build-0.1. | beta / 0.1 |
Kompatibilita
Grok Build čte konfiguraci konkurenčních nástrojů bez další práce — přechod nevyžaduje přepis nastavení.
| Zdroj | Co se přebere |
|---|---|
Claude Code | Marketplaces, pluginy, skilly, MCP, agenti, hooky a CLAUDE.md včetně .claude/rules/. |
.claude/settings.json | Pravidla oprávnění; pro deny-by-default se používá defaultMode. |
AGENTS.md | Podporuje AGENTS.md, Agents.md i AGENT.md, hledá se až ke kořeni repozitáře. |
~/.agents/ | Uživatelské skilly a příkazy z ~/.agents/skills/ a ~/.agents/commands/. |
Cursor | Konfigurace MCP serverů; slučuje se podle priority. |
/import-claude | Interaktivní import ~/.claude: oprávnění, env proměnné, MCP, hooky a cesty. |
Zdroje
Nic nenalezeno. Zkus název příkazu, sekce nebo kratší výraz.