x-searchlisted

# x-search X (Twitter) を Grok 経由で検索するスキル。Hermes Agent の Python API (`tools.x_search_tool`) を、`uv tool install` でローカル固定した hermes-agent venv の Python から直接呼び出す (毎回 git fetch しない / ネットアクセスは初回インストール時のみ)。 ## 前提 (ユーザー側で1度だけ手動実行が必要) 以下が未実行の場合、まずユーザーに案内すること。スキル内では自動化しない (ブラウザ操作・グローバル副作用を伴うため)。 1. **uv のインストール**: https://docs.astral.sh/uv/getting-started/installation/ 2. **hermes-agent のローカルインストール**: ``` uv tool install git+https://github.com/NousResearch/hermes-agent ``` `~/.local/share/uv/tools/hermes-agent/` 配下に専用 venv が作られ、`hermes` / `hermes-acp` / `hermes-agent` の 3 実行ファイルが `~/.local/bin/` に symlink される。 - 更新: `uv tool upgrade hermes-agent` - アンインストール: `uv tool uninstall hermes-agent` - hermes-agent は PyPI に未公開なので、必ず `git+https://...` を指定する (`uv tool install hermes-agent` だけだと `No solution found` で失敗する) 3. **xAI OAuth 認証**: ``` hermes auth add xai-oauth ``` 表示された URL をブラウザで開いて認証する。リモート (SSH) の場合は SSH ポートフォワード + `--no-browser` を使う: ``` ssh -L 56121:127.0.0.1:56121 user@remote-host \ 'hermes auth add xai-oauth --no-browser' ``` xAI のサブスクリプション (X Premium) が必要。 ### `HERMES_HOME` の注意 — グローバル認証 vs プロジェクトローカル認証 Hermes は credential を `$HERMES_HOME/auth.json` に保存する。`HERMES_HOME` が未設定なら `~/.hermes` がデフォルト。 このスキルは**グローバルスキル**として全プロジェクトから呼ばれるが、credential は `HERMES_HOME` ごとに別ファイルになる点に注意。 **推奨セットアップ: グローバル認証** direnv が効かない場所 (例: ホー���ディレクトリ) で1回認証して `~/.hermes/auth.json` を作る: ``` cd ~ hermes auth add xai-oauth ``` これで direnv 未設定のプロジェク