rules/grok-hermes-x-search.md の軽量化(2026-06-06)で逃がした詳細。手順本体はrulesに残し、解説・サンプル・旧手順をここに集約。

## なぜ x_search_tool 直接呼び出しが優れるか
従来の `hermes -z "x_searchを使って..."` は3段解釈(x_search_tool→Grok回答→Hermesモデル受取→目的エージェント)。`x_search_tool`直接呼びなら2段(Hermesモデル層を省略)で高速化+情報の薄まり防止。

## レスポンス構造(x_search_tool)
```json
{
"success": true, "provider": "xai", "credential_source": "xai-oauth",
"tool": "x_search", "model": "grok-4.20-reasoning", "query": "...",
"answer": "Markdown形式の回答([[N]](url)形式の脚注付きURL引用)",
"citations": [],
"inline_citations": [{"url":"https://x.com/...","title":"1","start_index":0,"end_index":100}]
}
```
- `answer`: Markdown + `[[N]](url)` 脚注付き引用。構造化されたX検索分析結果
- `model`: grok-4.20-reasoning(推論モデル) / `inline_citations`: URL+回答内位置
- パラメータ詳細: https://hermes-agent.nousresearch.com/docs/user-guide/features/x-search#tool-parameters

## 旧手順(Hermes本体インストール済みの場合)
```bash
hermes auth add xai-oauth
hermes -z "クエリ" --provider xai-oauth -m grok-4.3
```

## インストール済み状態(2026-06-02時点)
- uv: 済 / Hermes: `~/.local/bin/hermes` v0.13.0 / XAI_API_KEY: 未設定(OAuth経由でキー不要)
- grok CLI(`~/.grok/bin/grok` v0.2.16): 認証済 = qawasa+mutsumi_gokou@gmail.com(@GokouMutsumi・Xプレミアム)。`grok models`でgrok-buildデフォルト
- 再認証(SSH headless): `grok login --device-auth` → accounts.x.ai/oauth2/device をブラウザ承認
- ⚠️ grok CLIは`chat`サブコマンド廃止。現行ワンショットは`grok -p ""`(--single)。`--system-prompt-override`/`--always-approve`可
- Hermes xai-oauth: 2026-06-02再認証済(label xai-oauth-zasawa・X Premium @GokouMutsumi)。access_token 6h・refresh自動。`hermes auth status xai-oauth`→logged in
- x_search実働: `~/workspace/x-search-tool/x_search.py "クエリ"`(auth.jsonトークンで/v1/responses直接呼び・citations抽出OK)

## SSH headless 再認証(自前PKCE手動交換・確実)
rules本体に手順あり。要点=code_verifierをファイル保存→authorize URL生成→ユーザーが認可コード持参→token交換しauth.jsonにアトミック書込。revoke/tier_deniedの切り分けは`refresh_xai_oauth_pure`。認可コードは使い捨て・数分有効。

## 由来
2026-06-06 mdファイル軽量化(憲法<軽量)で六法的詳細をここへ。rules/grok-hermes-x-search.mdは最小セットアップ手順+このWiki参照に。