Hermes Agent CLI チートシート — コマンド、フラグ、スラッシュショートカット

セルフホスト型 Hermes エージェント用のシェルコマンドと TUI コマンド。

目次

Nous Research が提供する Hermes Agent は、ローカル環境またはVPS上で実行可能な、モデル非依存のツール利用型アシスタントです。

Hermes は特定のインターフェースに縛ることはしません。以下のいずれかを利用できます。

  • 従来の hermes / hermes chat CLI
  • フルスクリーン対応の hermes --tui セッション
  • Telegram、Discord、Slack など他のメッセージングプラットフォーム向けに長期実行される hermes gateway
  • Web エクストラがインストールされている場合、ローカルブラウザUI用の hermes dashboard

これら各モードは、~/.hermes 配下の同じ設定とデータを共有します。このページでは、これらのモード間で重要となる シェルコマンド を一覧にしています。

Hermes Agent CLI チートシート — ターミナルリファレンス

以下は、タスクごとにグループ化された 高密度のコマンドリファレンス です。

Hermes Agent のインストールと初回実行時のCLIコマンド

インストールやトラブルシューティングについては、まず Hermes AI アシスタント — インストール、セットアップ、ワークフロー、トラブルシューティング から開始してください。

インストーラーはリポジトリをプルし、Python 環境を設定して hermes 実行ファイルをセットアップします。source ~/.bashrc または ~/.zshrc を実行した後、対話型チャットのための デフォルトのエントリーポイント は単に hermes です（hermes chat と同じ系譜）。

コマンド 説明
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash 公式のワンラインインストール（Linux、macOS、WSL2）。
hermes / hermes chat インストール後の対話型チャットを開始（日々のデフォルトエントリー）。
hermes --version / hermes version バージョン情報を表示。
hermes completion bash | zsh | fish タブ補完用のシェル補完スクリプトを出力。
hermes update [--check] [--backup] [--restart-gateway] 最新コードを取得し、依存関係を再インストール。更新前のホームスナップショットやゲートウェイの再起動も任意で実行可能。
hermes uninstall [--full] [--yes] Hermes を削除。オプションでデータの完全削除が可能。

ネイティブの Windows はサポートされていません。WSL2 を使用してください。Termux 経由の Android でのインストールは、アップストリームのドキュメントに記載された専用のパスに従います。

すべての hermes 呼び出しに適用されるグローバルフラグ

これらのフラグはサブコマンドの前に適用され、どのプロファイル、どのセッション、またはどれだけ個人設定を読み込むかを変更します。

フラグ 説明
--profile, -p この実行で使用する Hermes プロファイルを選択（hermes profile use による粘着デフォルトを上書き）。
--resume, -r ID またはタイトルでセッションを再開。
--continue [name], -c 最新のセッション、またはタイトルに一致する最新のセッションを継続。
--worktree, -w 並列エージェント用に隔離された Git worktree で開始。
--yolo 危険なコマンドの承認プロンプトをバイパス（慎重に使用）。
--pass-session-id システムプロンプトにセッションIDを含める。
--ignore-user-config ~/.hermes/config.yaml をスキップ（デフォルトのみ使用）。.env は引き続き読み込まれます。
--ignore-rules AGENTS.md、SOUL.md、.cursorrules、メモリ、プリロードスキルの自動注入をスキップ。
--tui TUI を起動（HERMES_TUI=1 と同等）。
--dev --tui と併用して、tsx を使用して TS ソースを実行し、TUI 開発を行う。

隔離された自動化処理では、再現可能なワンショット実行のために hermes chat --ignore-user-config --ignore-rules と hermes -z を組み合わせて使うのが一般的です。

hermes chat、ワンショットプロンプト、および hermes -z

コマンド / パターン 説明
hermes chat 対話型またはスクリプト化されたチャット。-q、-m、--provider、ツールセット、再開、worktree、チェックポイントのメインサーフェス。
hermes chat -q "..." ワンショットプロンプト（非対話型）。ツールが実行される場合、-z よりもリッチな出力を保持。
hermes -z "..." スクリプト化されたワンショット — stdout に最終回答のみ出力し、バナーやセッションノイズなし。同じエージェントとツールを使用。パイプやスクリプトに最適。
hermes chat --quiet, -Q より静かなプログラムモード（バナーとツールプレビューを抑制）。
-m / --model, --provider 実行ごとのモデルとプロバイダーの上書き。環境変数 HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER で同じ動作を再現可能。
-t / --toolsets 実行中にカンマ区切りでツールセットを有効化。
-s / --skills スキルをプリロード（繰り返し指定またはカンマ区切り）。
--image path 単一クエリにローカル画像を添付。
--checkpoints 破壊的な編集前にファイルシステムチェックポイントを有効化。
--max-turns N ターンあたりのツール呼び出しイテレーションの上限を設定（設定ファイルからのデフォルト値）。
--source セッションソースタグ（統合のための cli と tool の区別）。

セッション外での Hermes モデルとセッション内の /model — シェルから hermes model を実行することは、プロバイダー、キー、OAuth を追加する場所です。スラッシュ /model は、すでに設定済みのプロバイダー間で切り替えるのみです。/model で OpenRouter しか見えない場合は、セッションを終了し、hermes model を完了してください。

モデルピッカー、認証情報プール、フォールバックプロバイダー

コマンド 説明
hermes model 対話型のプロバイダーとモデルのピッカー。キー、OAuth、カスタムエンドポイント。
hermes auth 認証情報プール — ロテーション対応のキーと OAuth のための add、list、remove、reset。
hermes fallback [list | add | remove | clear] primary がエラーまたはレート制限にかかった場合の、順序付きフォールバックプロバイダーを管理。
hermes setup [model | tts | terminal | gateway | tools | agent] [...] セクション別または完全な対話型セットアップ（--quick、--reset、--non-interactive）。

非推奨の hermes login / hermes logout — 代わりに hermes auth と hermes model を使用してください。

hermes model におけるローカルの OpenAI 互換エンドポイントとホステッドAPIの選択は、一般的な LLM ホスティング（レイテンシ、コスト、運用）と同じトレードオフを含みます。

デフォルトが Ollama などの上で Qwen や Gemma で終了する場合、どのモデルIDを入力したかと同じくらい、サンプラーのデフォルト値が重要です。エージェント向けの温度やペナルティのプリセットをまとめた参考情報を Qwen および Gemma 向けの Agentic LLM 推論パラメータ で確認してください。

設定ファイルと hermes config コマンド

設定の解決順序は CLI 上書き → config.yaml → .env → デフォルト です。API キーは .env に入れます。構造化された設定は config.yaml に入れます。

コマンド 説明
hermes config show 有効な設定を表示。
hermes config edit $EDITOR で config.yaml を開く。
hermes config set key value 値を設定（シークレットは .env に、非シークレットは YAML にルーティング）。
hermes config path / hermes config env-path 設定ファイルと環境ファイルへのパスを表示。
hermes config check 欠落または古い設定を検出。
hermes config migrate 新たに導入されたオプションを対話的に適用。

ファイルの保存場所 — 設定、シークレット、メモリ、スキル、セッション、ゲートウェイ状態、ログなどすべては、HERMES_HOME（デフォルトは ~/.hermes）配下に置かれます。

セッション管理と hermes profile

コマンド 説明
hermes sessions list 最近のセッションをリスト表示。
hermes sessions browse 検索と再開機能付きの対話型ピッカー。
hermes sessions export セッションをエクスポート（例: JSONL）。
hermes sessions delete, prune, rename, stats 1つのセッションを削除、古いセッションを整理、タイトルをリネーム、ストア統計を表示。
hermes profile list | use | create | delete | show | rename 1つのマシン上の隔離された Hermes インスタンスを管理。
hermes profile export / import プロファイルのタールボールをアーカイブまたは復元。
hermes profile alias プロファイルの素早い切り替え用のショートラッパースクリプト。

粘着デフォルトプロファイルを変更せずにアドホックな実行を行う場合は、hermes -p work chat -q "..." を使用してください。

スキルハブ、ツールセット、シェルフック、プラグイン

ロールに基づいた実際の本番環境ワークフローに調整された、プロファイルファーストな設定とスキルについては、実環境セットアップ向けの Hermes AI アシスタントスキル を参照してください。SKILL.md ファイルの作成とデバッグ（メタデータ、段階的開示、条件付き可視性）については、Hermes Agent スキル作成 — SKILL.md の構造とベストプラクティス を参照してください。

コマンド 説明
hermes tools プラットフォームごとの対話型ツール有効化。--summary で現在の選択を表示。
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config レジストリとURLインストールを含むスキルハブワークフロー。
hermes curator status, run, pause, pin, rollback, … バックグラウンドでのスキル保守と安全なロールバック。
hermes hooks list, test, revoke, doctor 設定内で宣言されたシェルフックと許可リスト。
hermes plugins プラグインをインストール、有効化、無効化、削除するための複合UIまたはサブコマンド。

ビルトインメモリと hermes memory プロバイダー

ビルトインの MEMORY.md / USER.md は常に有効です。外部プロバイダーはオプションの呼び出しレイヤーを追加します。そのアーキテクチャが実際にはどう動作するかについては、Hermes Agent メモリシステム — 永続AIメモリが実際に動作する仕組み をお読みください。外部バックエンドとアクティベーションのトレードオフを比較するには、Agent Memory プロバイダー比較 — Honcho、Mem0、Hindsight、そしてさらに5つ を参照してください。

コマンド 説明
hermes memory setup 対話型の外部メモリプロバイダー設定。
hermes memory status アクティブなプロバイダー設定を表示。
hermes memory off 外部プロバイダーを無効化。ビルトインファイルは残ります。

プロバイダーがアクティブな場合、プロバイダー固有の追加のトップレベルサブコマンドが登録される可能性があります — 現在何がセットアップされているかを確認するには hermes --help を実行してください。

メッセージングゲートウェイ、DMペアリング、プラットフォーム

コマンド 説明
hermes gateway setup 対話型のメッセージングプラットフォーム設定。
hermes gateway run フォアグラウンドゲートウェイ（WSL、Docker、Termux で推奨）。
hermes gateway start | stop | restart | status systemd / launchd サービス制御（--all はすべてのプロファイルのゲートウェイに影響）。
hermes gateway install | uninstall ユーザーレベルのバックグラウンドサービスをインストールまたは削除。
hermes pairing list | approve | revoke | clear-pending メッセージングボットのための DM ペアリング承認。
hermes whatsapp WhatsApp ブリッジペアリングフロー。
hermes slack manifest ゲートウェイのスラッシュコマンド対応 Slack アプリマニフェストを生成。

WSL では、gateway start が不安定な場合、tmux 内で hermes gateway run を実行するのが耐障害性の高いパターンです。同じゲートウェイレイヤーを使用するエンドツーエンドのスマートフォンワークフローについては、スマートフォンからの Hermes Voice Control を参照してください。 専用サーバーでの運用と独立したデスクトップクライアントの場合、Hermes Agent ヘッドレスサーバーとリモートデスクトップセットアップ に従ってください。

Cron スケジューラー、Webhook、カンバン

コマンド 説明
hermes cron … 定期実行プロンプトの作成、編集、一時停止、再開、実行、削除（手動スケジューラーパスのための tick）。
hermes webhook subscribe, list, remove, test イベント駆動実行用の動的 Webhook ルート。
hermes kanban … SQLite によるバックエンドを持つマルチプロファイルタスクボード。dispatch がワーカーを駆動します。

セルフホスト型ゲートウェイでの hermes kanban の実用的な並行性パターンが必要の場合は、セルフホスト型 LLM ワークフロー向けの Hermes Agent でのカンバン を参照してください。

hermes doctor、ログ、バックアップ、使用状況インサイト

コマンド 説明
hermes doctor [--fix] 対話型の診断と任意の自動修復。
hermes status [--all] [--deep] 簡潔な状態表示。必要に応じて深いチェック。
hermes dump [--show-keys] Discord や GitHub のイシュー向けに貼り付けやすいセットアップ概要。
hermes debug share 編集されたデバッグバンドルをペーストサービスにアップロード（または --local）。
hermes logs [agent | errors | gateway | list] プロファイルのログディレクトリ配下のログをテールおよびフィルター。
hermes backup, hermes import ホームデータの Zip スナップショットと復元パス。
hermes insights [--days N] [--source …] トークン、コスト、アクティビティの分析。

アップグレード後に何か問題が発生した場合、hermes doctor、hermes status、そして hermes logs errors -f が最も迅速なトリアージループを形成します。

MCP、ACP、Web ダッシュボード、OpenClaw 移行

コマンド 説明
hermes mcp serve Hermes を MCP サーバーとして実行。
hermes mcp add, remove, list, test, configure Hermes からの MCP クライアント接続を管理。
hermes acp エディター向けの Agent Client Protocol stdio サーバー（追加インストールが必要な場合があります）。
hermes dashboard [--port …] [--host …] ローカル Web ダッシュボード（pip install hermes-agent[web]）。
hermes claw migrate … OpenClaw スタイルの設定を Hermes に移行（--dry-run、プリセット、任意のシークレット）。

OpenClaw 移行 — hermes claw migrate は従来の OpenClaw ホームディレクトリを読み取ります。ドライランレビュー、競合ポリシー、シークレット処理、チャンネル引き継ぎを含む完全な段階的切り替えは、OpenClaw から Hermes Agent への安全な移行方法 で説明されています。移動前のそのスタックがどのようなものだったかについては、OpenClaw 事例研究 を参照してください。

Hermes CLI セッションでのスラッシュコマンド

自動補完のために / を入力してください。コマンドは 大文字小文字を区別しません。スキルは追加の /skill-name ルートを登録します。以下のテーブルは厳選されたサブセットであり、完全なレジストリについては、この記事末尾の 公式 Hermes Agent ドキュメント を参照してください。

セッションフロー、バックグラウンドタスク、目標

コマンド 説明
/new, /reset 新しいセッションIDと履歴。
/resume [name] 名前付きセッションを再開。
/compress [focus] オプションのフォーカス トピック付きの手動コンテキスト圧縮。
/retry, /undo 最後のターンを再試行または最後の交換を破棄。
/title … 後での /resume のためにセッションに名前を付ける。
/background …, /queue …, /steer … 並列バックグラウンド実行、キューに追加された次のプロンプト、次のツール実行後のループ中の方向修正。
/goal … ジャッジループ付きの永続的マルチターン目標（status、pause、resume、clear）。
/branch, /fork 代替的な探求のために会話をブランチ。

モデル、ツールトグル、スキル、リロード

コマンド 説明
/model … [--global] 設定済みプロバイダー間でモデルを切り替え。--global でデフォルトを永続化。
/tools …, /toolsets セッションのツールトグルとツールセットのリスト表示。
/skills … チャットからスキルを検索、インストール、管理。
/cron … CLI セッションからのスケジュールタスクUI。
/reload-mcp 設定から MCP サーバーをリロード。
/reload 再起動せずに .env を実行中のセッションにリロード。

使用状況、ヘルプ、終了

コマンド 説明
/usage, /insights トークンとコストの可視性。分析スナップショット。
/help, /quit ヘルプを表示または CLI を終了。

メッセージングアプリ（Telegram、Discord、Slack など）は、重複するスラッシュセットに加えて、/approve、/restart、/commands、および関連するゲートウェイ専用のヘルパーを提供します — プラットフォーム間の違いは、下記の 公式 Hermes Agent ドキュメント のスラッシュコマンドリファレンスに記載されています。

その他の有用な資料

このサイトの関連ページ（Hermes とターミナルエージェントのより広い文脈）：

公式 Hermes Agent ドキュメント

hermes-agent.nousresearch.com 上のアップストリームドキュメント：

ヒント。 hermes dump と hermes doctor --fix を筋肉記憶として保持してください — それらは曖昧な「何か壊れた」という報告を、既知の正常なセットアップに対する実行可能な差分に変えます。

購読する

システム、インフラ、AIエンジニアリングの新記事をお届けします。