Hermes Agent CLI チートシート — コマンド、フラグ、およびスラッシュショートカット
セルフホスト型Hermesエージェント向けのシェルおよびTUIコマンド
Nous Research の Hermes Agent は、モデルに依存せず、ローカルまたは VPS で実行できるツール対応アシスタントです。
Hermes は特定のインターフェースに縛られることはありません。以下の方法で利用できます。
- 従来の
hermes/hermes chatCLI - フルスクリーンの
hermes --tuiセッション - Telegram、Discord、Slack、その他のメッセージングプラットフォーム向けの長期間稼働する
hermes gateway - Web 追加機能がインストールされている場合のローカルブラウザ UI である
hermes dashboard
これらのパスはすべて ~/.hermes 下で同じ設定とデータ共有します。このページでは、これらのモード全体で重要な シェルコマンド をリストしています。
以下は、タスク別にグループ化した 密集したコマンドリファレンス です。
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 ホスティング （レイテンシ、コスト、運用）と同じトレードオフに基づきます。
設定ファイルと 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 アシスタント スキル for 実運用セットアップ を参照してください。
| コマンド | 説明 |
|---|---|
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 Memory System — 永続的AIメモリが実際にどのように機能するか を読んでください。外部バックエンドと活性化のトレードオフを比較するには、Agent Memory Providers Compared — Honcho, Mem0, Hindsight, and Five More を参照してください。
| コマンド | 説明 |
|---|---|
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 が堅牢なパターンです。
Cron スケジューラ、ウェブフック、および Kanban
| コマンド | 説明 |
|---|---|
hermes cron … |
スケジュールされたプロンプトの作成、編集、一時停止、再開、実行、削除（tick で手動スケジューラパス）。 |
hermes webhook subscribe, list, remove, test |
イベント駆動型実行用の動的ウェブフックルート。 |
hermes kanban … |
SQLite でバックアップされたマルチプロファイルタスクボード；dispatch がワーカーを駆動。 |
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、ウェブダッシュボード、および 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 …] |
ローカルウェブダッシュボード（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 とターミナルエージェントのより広い文脈）：
- AI Systems — セルフホスト型アシスタント、RAG、およびローカルインフラストラクチャ — クラスタ概要とアシスタントがスタックにどのように適合するか
- AI Systems Memory — メモリハブと関連ガイド
- AI Developer Tools — ターミナルとIDEツールングの風景
- OpenCode Quickstart — エルゴノミクスの比較のための別のターミナルファーストエージェント
公式 Hermes Agent ドキュメント
hermes-agent.nousresearch.com でのアップストリームドキュメント：
ヒント。 hermes dump と hermes doctor --fix を筋肉記憶に保持してください — これらは曖昧な「何か壊れた」レポートを、既知の良い設定に対する実行可能な差分に変えます。
