Grok

xAI の Grok Build CLI にコーディングを任せます（機能追加、PR）。

skill の情報

参考: SKILL.md 全文

Grok Build CLI — Hermes からの動かし方

Hermes のターミナル経由で、Grok Build（xAI が 作った自律型のコーディングエージェント CLI、grok コマンド）にコーディングを 任せます。Grok はファイルを読み、コードを書き、シェルコマンドを実行し、サブ エージェントを立ち上げ、git の作業も進められます。動かし方は三通りあります。 対話型の TUI、ヘッドレス（-p）、そして JSON-RPC 経由の ACP エージェント です。

これは codex、claude-code に続く三番目の兄弟にあたります。動かし方の型は ほぼ同じで、一回で終わる作業にはヘッドレスの -p が向いています。対話が 続くセッションでは PTY を使ってください。

こんなときに使います

• 機能を作るとき
• コードを書き直すとき
• PR をレビューするとき
• Issue をまとめて片付けるとき
• ふだんなら Codex や Claude Code に任せるところを、Grok にやらせたいとき

事前に必要なもの

• インストール（推奨）: npm install -g @xai-official/grok
  • 公式のインストーラ curl -fsSL https://x.ai/cli/install.sh | bash でも入りますが、

環境によっては x.ai のホストが Cloudflare で遮られます。npm 経由なら そこに依存せずに済みます。

• 認証 — SuperGrok / X Premium+ の契約を使う方法（こちらが基本）:
  • grok login を一度実行すると、ブラウザが開いて OAuth になり、トークンが

~/.grok/auth.json に保存されます。ここでは SuperGrok または X Premium+ の 契約を使うので、トークン単位の API 課金は発生しません。

• サインインできているかどうかは ~/.grok/auth.json の有無で確認するか、

軽いヘッドレスの動作確認を実行してください: grok --no-auto-update -p "Say ok."

• TUI では /logout でサインアウト、/login（または起動しなおし）でサインインします。
• git リポジトリは不要 — Codex とは違い、Grok は git ディレクトリの外でも

問題なく動きます（使い捨ての作業に向いています）。

• Claude Code / AGENTS.md と設定なしでそのまま噛み合います — Grok は

CLAUDE.md、.claude/（skill、エージェント、MCP、hook、ルール）、 AGENTS.md 系のファイルを自動で読みます。既存のプロジェクトの前提が そのまま効きます。

> API キーを使う代替手段（この利用者向けの既定ではありません）: Grok は > XAI_API_KEY 環境変数を設定して、api.x.ai 経由の従量課金で使うこともできます。 > ただしこれは > grok login や SuperGrok の認証が使えないときだけにしてください。ここで > 想定しているのは契約を使う方法（grok login）です。

二つの動かし方

方法 1: ヘッドレス（-p）— 対話なしで動かす（おすすめ）

作業を一回だけ実行し、結果を表示して終了します。PTY も要らず、対話の画面を 操作する必要もありません。いちばん素直な使い方で、claude -p や codex exec に あたります。

terminal(command="grok --no-auto-update -p 'Add a dark mode toggle to settings'", workdir="/path/to/project", timeout=180)

自動実行では常に --no-auto-update を付けて、裏側の更新チェックを止めてください。

ヘッドレスが向く場面:

• 一回で終わるコーディング作業（バグ修正、機能追加、書き直し）
• CI/CD の自動化やスクリプト
• --output-format json で構造化された出力を受け取って処理するとき
• 何度もやりとりする必要がない作業

方法 2: 対話型の PTY — TUI で何度もやりとりする

TUI は画面全体を使う、マウス操作もできるアプリです。pty=true で動かします。 安定して監視・入力するには tmux を使ってください（claude-code skill と同じ型です）。

# Launch in a tmux session for capture-pane monitoring
terminal(command="tmux new-session -d -s grok-work -x 140 -y 40")
terminal(command="tmux send-keys -t grok-work 'cd /path/to/project && grok' Enter")

# Wait for startup, then send a task
terminal(command="sleep 5 && tmux send-keys -t grok-work 'Refactor the auth module to use JWT' Enter")

# Monitor progress
terminal(command="sleep 15 && tmux capture-pane -t grok-work -p -S -50")

# Exit when done
terminal(command="tmux send-keys -t grok-work '/quit' Enter && sleep 1 && tmux kill-session -t grok-work")

TUI の見た目のまま行内に出したいとき: 画面全体を乗っ取る表示なしで TUI 風の 出力がほしい場合（ログを読みやすくしたいときなど）は --no-alt-screen を付けます。 純粋な自動化であれば、やはりヘッドレスの -p のほうがすっきりします。

ヘッドレスをもう少し詳しく

よく使うフラグ

出力の形式

• plain — 人が読む形のテキスト（既定）
• json — 実行の最後に JSON オブジェクトを一つ出します（結果をきれいに処理できます）
• streaming-json — 改行区切りの JSON イベントを、届いた順に出します

# Structured result for parsing
terminal(command="grok --no-auto-update -p 'List all TODO comments in src/' --output-format json", workdir="/project", timeout=120)

# Auto-approve for autonomous building
terminal(command="grok --no-auto-update --always-approve -p 'Refactor the database layer and run the tests'", workdir="/project", timeout=300)

バックグラウンド実行（長い作業）

# Start headless in background
terminal(command="grok --no-auto-update --always-approve -p 'Refactor the auth module'", workdir="/project", background=true, notify_on_complete=true)
# Returns session_id

# Monitor
process(action="poll", session_id="<id>")
process(action="log", session_id="<id>")

# Kill if needed
process(action="kill", session_id="<id>")

対話型（TUI）のままバックグラウンドで動かしたいときは、claude-code や codex skill とまったく同じように pty=true と tmux を使い、tmux capture-pane で 様子を見てください。

セッションの続きから

セッションは名前ではなく UUID で管理されます。--session-id は新しい実行に *新規の* UUID を割り当てるもので、再開はしません。--resume には既存の セッションの UUID を渡します（値を省略すると直近のものを再開します）。

# Start a session with a self-assigned UUID (must be a valid, unused UUID)
SID=$(uuidgen)
terminal(command="grok --no-auto-update -s $SID -p 'Start refactoring the database layer' --always-approve", workdir="/project", timeout=240)

# Resume that exact session later by its UUID
terminal(command="grok --no-auto-update -r $SID -p 'Now add connection pooling' --always-approve", workdir="/project", timeout=180)

# Or just continue the most recent session in this directory (no UUID needed)
terminal(command="grok --no-auto-update -c -p 'What did you change last time?'", workdir="/project", timeout=60)

読むだけの点検から markdown のノートを作る型

手元のファイルを Grok に見てもらい、何も書き換えずにきれいな markdown の ノートだけを受け取りたいとき（Obsidian やリポジトリに置く用）は次のようにします。

1. まず Hermes のツール（read_file、write_file）で、入力になるファイルを

固めておきます。パスをそのまま渡すのではなく、関係する内容だけを一時 ファイルに切り出してください。

1. --always-approve を 付けずに ヘッドレスで実行して、勝手に書き込めない

ようにし、markdown only, no preamble と指示します。

1. Grok の標準出力をそのまま write_file() で目的のノートに保存します。

grok --no-auto-update -p "Read /tmp/current.md and /tmp/inventory.md. Produce markdown only, no preamble. Output a clean note titled 'Cleanup Review'." --output-format plain

気をつける点（Claude Code と同じです）: 文書を書き直させるとき、「これを 書き直して」という緩い指示だと、全文ではなく変更点の要約が返ってくることが あります。そうではなく、ファイルの中身を渡したうえで Return ONLY the full revised markdown document. No intro, no explanation, no code fences. Start immediately with '# Title'. と指示してください。 書き出し先を上書きする前に、read_file() で先頭の数行を確認しましょう。

PR レビューの型

さっと見てもらう（ヘッドレス）

terminal(command="cd /path/to/repo && git diff main...feature-branch | grok --no-auto-update -p 'Review this diff for bugs, security issues, and style problems. Be thorough.'", timeout=120)

一時ディレクトリに clone してレビューする（リポジトリを触らない安全な方法）

terminal(command="REVIEW=$(mktemp -d) && git clone https://github.com/user/repo.git $REVIEW && cd $REVIEW && gh pr checkout 42 && grok --no-auto-update -p 'Review the changes vs origin/main. Check bugs, security, race conditions, missing tests.'", pty=true, timeout=300)

レビュー結果を投稿する

terminal(command="gh pr comment 42 --body '<review text>'", workdir="/path/to/repo")

worktree を使って Issue を並行して直す

# Create worktrees
terminal(command="git worktree add -b fix/issue-78 /tmp/issue-78 main", workdir="~/project")
terminal(command="git worktree add -b fix/issue-99 /tmp/issue-99 main", workdir="~/project")

# Launch Grok headless in each (background)
terminal(command="grok --no-auto-update --always-approve -p 'Fix issue #78: <description>. Commit when done.'", workdir="/tmp/issue-78", background=true, notify_on_complete=true)
terminal(command="grok --no-auto-update --always-approve -p 'Fix issue #99: <description>. Commit when done.'", workdir="/tmp/issue-99", background=true, notify_on_complete=true)

# Monitor
process(action="list")

# After completion: push and open PRs
terminal(command="cd /tmp/issue-78 && git push -u origin fix/issue-78")
terminal(command="gh pr create --repo user/repo --head fix/issue-78 --title 'fix: ...' --body '...'")

# Cleanup
terminal(command="git worktree remove /tmp/issue-78", workdir="~/project")

便利なサブコマンドと TUI のコマンド

TUI のスラッシュコマンド（対話時のみ）: /model <name>、/always-approve、 /plan、/context、/compact、/resume、/sessions、/fork、/usage、 /quit。Shift+Tab でセッションのモードを切り替えます（セッションの計画 ファイル以外への書き込みを止める Plan モードも含みます）。

設定（~/.grok/config.toml）

[cli]
auto_update = false          # skip background update checks persistently

[ui]
permission_mode = "ask"      # or "always-approve" to skip tool prompts by default

[models]
default = "grok-build-0.1"

全体に効かせたい設定は、プロジェクトごとの .grok/config.toml ではなく ~/.grok/config.toml に置いてください。permission_mode は、古い approval_mode / yolo = true より優先されます。

つまずきやすいところ

1. 認証には契約が要ります。 grok login には SuperGrok または X Premium+ の

契約が必要です。ログインに失敗する、あるいは ~/.grok/auth.json が無い 場合は、XAI_API_KEY に切り替える前に契約が有効かどうかを確かめてください。

1. Hermes 側の xAI 認証と grok CLI の認証を混同しないでください。 Hermes の

x_search は Hermes 自身の xAI OAuth で動きます。単独の grok CLI は ~/.grok/auth.json に別のトークンを持ちます。x_search が動いているからと いって、grok がログイン済みだとは限りません。

1. 自動実行では必ず --no-auto-update を付けてください — 付けないと Grok が

更新チェックのために外へ通信します（x.ai や storage.googleapis.com に つながらないこともあります）。

1. curl のインストーラより npm を使ってください — `npm install -g

@xai-official/grok なら、Cloudflare で遮られる x.ai` のホストを避けられます。

1. --always-approve が自律的に作らせるためのスイッチです。 これが無いと、

ヘッドレスの実行がツールの承認待ちで止まることがあります。読むだけの レビューや点検では、Grok がファイルを書き換えられないよう、あえて外して ください。

1. ヘッドレスの -p は TUI の画面を出しません。TUI を使うときは

pty=true（監視するなら tmux も）が要ります。Claude Code と同じです。

1. TUI を行内で動かしていて、画面全体を使う表示のせいで取得した出力が

崩れるときは --no-alt-screen を使ってください。

1. git リポジトリは不要ですが、PR やコミットの作業では結局あったほうが

よいので、使い捨てのコミット作業には mktemp -d && git init を使ってください。

1. 終わったら tmux kill-session -t <name> で tmux のセッションを片付けてください。

Hermes のエージェント向けのルール

1. 一つの作業なら ヘッドレスの -p を選んでください — いちばん素直で、

--output-format json で構造化された出力も受け取れます。

1. Grok が正しいプロジェクトを見るよう、**workdir（または --cwd）を必ず

指定してください**。

1. 自動で呼び出すときは毎回 --no-auto-update を付けてください。
2. --always-approve は、Grok に自分で書き込ませたいときだけ使ってください。

読むだけのレビューや点検では外します。

1. 長い作業は background=true, notify_on_complete=true で **バックグラウンドに

回し**、process ツールで様子を見てください。

1. 何度もやりとりする作業では tmux を使い、

tmux capture-pane -t <session> -p -S -50 で監視してください。

1. 頼る前に認証を確かめてください — ~/.grok/auth.json を見るか、

軽く grok -p "Say ok." を実行して確認します。Hermes 側の xAI 認証が 引き継がれると思い込まないでください。

1. 結果を利用者に伝えてください — Grok が何を変えて、何が残っているかを

まとめます。