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 を使用してください。Android は Termux を通じてインストールされ、アップストリームドキュメントで専用のパスが示されています。

全 hermes 呼び出し用のグローバルフラグ

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

フラグ 説明
--profile, -p この実行用の Hermes プロファイルを選択（hermes profile use によるスティッキーデフォルトをオーバーライド）。
--resume, -r ID またはタイトルでセッションを再開。
--continue [name], -c 最新のセッション、またはタイトルに一致する最新セッションを続行。
--worktree, -w 並列エージェント用の孤立した Git ワークツリーで開始。
--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、ツールセット、再開、ワークツリー、チェックポイントの主要なインターフェース。
hermes chat -q "..." ワンショットプロンプト（非対話型）。ツールが実行される場合、-z よりも豊富な出力を保持。
hermes -z "..." スクリプト化されたワンショット — 最終回答のみを標準出力に出力し、バナーやセッションノイズなし。同じエージェントとツールを使用。パイプやスクリプトに最適。
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 vs tool（統合用））。

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

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

コマンド 説明
hermes model 対話型プロバイダとモデルピッカー。キー、OAuth、カスタムエンドポイント。
hermes auth 認証情報プール — add、list、remove、reset により、ローテーション対応のキーと OAuth を管理。
hermes fallback [list | add | remove | clear] 一次元プロバイダがエラーまたはレート制限になった場合の、順序付きフォールバックプロバイダの管理。
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 用のエージェント型 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つのセッションの削除、古いセッションの整理、タイトルのRename、ストア統計の表示。
hermes profile list | use | create | delete | show | rename 1台のマシン上の孤立した Hermes インスタンスの管理。
hermes profile export / import プロファイルのtarballのアーカイブまたは復元。
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メモリが実際に機能する仕組み を参照してください。外部バックエンドとアクティブ化のトレードオフを比較するには、エージェントメモリプロバイダ比較 — 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 電話からの音声制御 を参照してください。 独立したデスクトップクライアントを伴う専用サーバー運用については、Hermes Agent ヘッドレスサーバーとリモートデスクトップセットアップ を参照してください。

Cron スケジューラ、Webhook、Kanban

コマンド 説明
hermes cron … スケジュールされたプロンプトの作成、編集、一時停止、再開、実行、削除（tick で手動スケジューラパス）。
hermes webhook subscribe, list, remove, test イベント駆動型実行用の動的Webhookルート。
hermes kanban … SQLite で裏打ちされたマルチプロファイルタスクボード。dispatch がワーカーを駆動。

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

hermes doctor、ログ、バックアップ、利用インサイト

コマンド 説明
hermes doctor [--fix] 対話型診断とオプションの自動修復。
hermes status [--all] [--deep] 簡潔なステータス。必要な場合の深いチェック。
hermes dump [--show-keys] Discord または GitHub issue 用のペーストしやすいセットアップサマリー。
hermes debug share 編集されたデバッグバンドルをペーストサービスにアップロード（または --local）。
hermes logs [agent | errors | gateway | list] プロファイルのログディレクトリ下のログのTailとフィルタリング。
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 エディタ用のエージェントクライアントプロトコル 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 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エンジニアリングの新記事をお届けします。