CLI 画面

Hermes Agent の CLI は、Web の画面ではなく、ターミナル上で完結する本格的な操作画面（TUI）です。複数行の編集、スラッシュコマンドの入力補完、会話履歴、実行中の割り込みと軌道修正、ツール出力のストリーミング表示を備えています。ターミナルで一日を過ごす人のために作られています。

CLI を起動する

# Start an interactive session (default)
hermes

# Single query mode (non-interactive)
hermes chat -q "Hello"

# Single query from a file or stdin — nothing is shell-interpreted, so
# arbitrary text (quotes, $(...), backticks) arrives verbatim
hermes chat --query-file prompt.txt
hermes chat --query-file - < prompt.txt

# With a specific model
hermes chat --model "anthropic/claude-sonnet-4"

# With a specific provider
hermes chat --provider nous        # Use Nous Portal
hermes chat --provider openrouter  # Force OpenRouter

# With specific toolsets
hermes chat --toolsets "web,terminal,skills"

# Start with one or more skills preloaded
hermes -s hermes-agent-dev,github-auth
hermes chat -s github-pr-workflow -q "open a draft PR"

# Resume previous sessions
hermes --continue             # Resume the most recent CLI session (-c)
hermes --resume <session_id>  # Resume a specific session by ID (-r)
hermes --resume latest        # Resume the most recent session (same as -c)
hermes --resume latest --in ./dir  # Resume ./dir's latest session, staying in ./dir

# Verbose mode (debug output)
hermes chat --verbose

# Isolated git worktree (for running multiple agents in parallel)
hermes -w                         # Interactive mode in worktree
hermes -w -z "Fix issue #123"     # Single query in worktree

worktree の掃除

hermes -w で始めたセッションは、使い捨ての worktree を <repo>/.worktrees/ の下に作ります。 起動時には控えめな掃除処理が自動で走りますが（消すのは、変更がなく完全にマージ済みで、一定の日数が経った作業ツリーだけです）、 残すよう指定したツリーやマージ済みのローカルブランチは、よく使う端末ほど溜まっていきます。次のコマンドで 明示的に片づけてください。

hermes worktree list              # audit: age, size, verdict, reason per tree
hermes worktree prune             # remove safe trees + delete merged branches
hermes worktree prune --dry-run   # show the plan without changing anything
hermes worktree prune --trees-only     # leave local branches alone
hermes worktree prune --branches-only  # leave worktrees alone

セッションの中からは /worktree prune [--dry-run] で同じことができます（実行中のセッション自身が使っている ツリーには決して触れません）。

安全面の保証は、どのモードでも、どれだけ古いツリーでも共通です。

• コミットしていない 追跡対象 の変更は、決して削除されません。
• プッシュされていない固有のコミット も削除されません。上流で rebase や squash によりマージされた

コミットは、git cherry のパッチ等価判定で検出され、マージ済みとして扱われます。これによって、 「PR はマージされたのにツリーが永久に残る」という最も多い溜まり方をようやく回収できます。

• 稼働中の hermes セッションが使っている ツリーには手を出しません。
• 追跡対象がない一時ファイルだけ のツリー（PR 本文の下書きやメモなど）は、削除の前に

~/.hermes/archive/worktree-prune/ へ退避されます。捨てられることはありません。

• ブランチの削除は名前ではなく中身で判断します。コミットがすべて上流にあるローカルブランチは削除して

安全です。固有の作業が残っているブランチ、チェックアウト中のブランチ、main/master/develop は 常に残ります。

.worktrees/ がツリー 10 個または 5 GB を超えると、起動時にこれらのコマンドを案内する1行の お知らせが出ます。

プラグインの管理

hermes plugins 系のコマンドは、Hermes ネイティブのプラグインと、持ち運びできる Agent Plugins v1 のパッケージを、同じ「自分で有効にする」流れで管理します。

hermes plugins install owner/repository --no-enable
hermes plugins list
hermes plugins enable <plugin-name>
hermes plugins disable <plugin-name>
hermes plugins update <plugin-name>
hermes plugins remove <plugin-name>

持ち運び形式のパッケージは、明示的に有効にするまで無効のままです。Hermes が現在読み込むのは、 持ち運び形式の Agent Skills と stdio 形式の MCP エントリです。対応している範囲と信頼の境界の詳細は プラグイン開発ガイド を参照してください。

画面の構成

*Hermes CLI のバナー、会話の流れ、固定された入力欄を、崩れやすいアスキーアートではなく安定した図として描いたものです。*

ウェルカムバナーには、モデル、ターミナルのバックエンド、作業ディレクトリ、使えるツール、入っているスキルがひと目で分かるように並びます。

ステータスバー

入力欄の上には、常に表示されて刻々と更新されるステータスバーがあります。

 ⚕ claude-sonnet-4-20250514 │ 12.4K/200K │ [██████░░░░] 6% │ $0.06 │ 15m

バーは端末の幅に合わせて変わります。76 桁以上ならフル表示、52〜75 桁なら簡略表示、52 桁未満なら最小表示（モデルと経過時間、YOLO が有効ならそのバッジ）です。

コンテキストの色分け:

入力と出力それぞれのトークンなど、項目別の費用も含めた内訳は /usage で確認できます。

openai-codex プロバイダーでは、/usage が ChatGPT アカウントに貯まっている利用上限のリセット権も表示します（「You have N resets banked - use /usage reset to activate」）。/usage reset を実行すると貯まったリセット権を1つ使い、5時間ごとの上限と週次の上限が完全に回復します。上限に達していないうちは、Hermes はリセットを拒否します（リセット権は上限をまるごと戻すものなので、早く使うと損になります）。それでも実行したい場合は /usage reset --force を渡してください。

再開時の表示

前のセッションを再開すると（hermes -c または hermes --resume <id>）、バナーと入力欄のあいだに「Previous Conversation」というパネルが現れ、会話履歴の要約がコンパクトに表示されます。詳細と設定は セッション — 再開時の会話の振り返り を参照してください。

キー操作

複数行の貼り付けプレビュー。 複数行のかたまりを貼り付けると、CLI は全文をそのまま流さず、1行に畳んだプレビュー（[pasted: 47 lines, 1,842 chars — press Enter to send]）を表示します。実際に送られるのは全文のままで、これは表示上の工夫です。

! シェルモード

行頭に ! を付けると、その行はエージェントには送られず、シェルコマンドとして実行されます。

> !git status
> !ls -la
> !pytest -x tests/cli

• 費用はゼロ。 モデルは一切呼ばれません。API 呼び出しもトークン消費も待ち時間もありません。
• 会話には残らない。 コマンドも出力も履歴に加わらないので、コンテキストはきれいなまま、プロンプトキャッシュも壊れません。
• エージェントの terminal ツールと同じ場所で動く。 セッションの作業ディレクトリを使うので、!pwd の結果はエージェントから見えるものと一致します。
• 承認の仕組みはそのまま。 危険なコマンド（rm -rf、~/.hermes/config.yaml への書き込みなど）は、エージェントの terminal ツールと同じ承認プロンプトを通ります。! は費用と待ち時間の近道であって、安全機構の抜け道ではありません。
• 失敗したら分かる。 終了コードが 0 でないときは、出力のあとに ! exited <code> と表示されます。
• ! だけを打つと、使い方が1行で表示されます。

シェルモードは CLI 専用です。ゲートウェイのプラットフォーム（Discord、Telegram、Slack）や cron 実行では無視されます。そちらの利用者は、すでに自分のシェルを持っているからです。

最終応答の Markdown 除去。 CLI は、エージェントの *最終的な* 返答から、冗長になりがちなコードフェンスや bold / *italic* の装飾を取り除き、ターミナルで読みやすい文章として表示します。コードブロックと箇条書きはそのまま残ります。ゲートウェイのプラットフォームやツールの実行結果には影響しません。そちらは各自の描画のために Markdown を保持します。

スラッシュコマンド

/ と打つと入力補完が出てきます。Hermes には、CLI のスラッシュコマンド、スキル由来の動的なコマンド、自分で定義したクイックコマンドが数多くあります。

よく使うものは次のとおりです。

CLI とメッセージングの組み込みコマンド全一覧は スラッシュコマンド一覧 を参照してください。

セットアップ、プロバイダー、無音判定の調整、メッセージングや Discord での音声利用については 音声モード を参照してください。

クイックコマンド

LLM を呼ばずに、シェルコマンドをその場で実行する独自コマンドを定義できます。CLI でも、メッセージングのプラットフォーム（Telegram、Discord など）でも使えます。

# ~/.hermes/config.yaml
quick_commands:
  status:
    type: exec
    command: systemctl status hermes-agent
  gpu:
    type: exec
    command: nvidia-smi --query-gpu=utilization.gpu,memory.used --format=csv,noheader
  restart:
    type: alias
    target: /gateway restart

あとは、どのチャットでも /status、/gpu、/restart と打つだけです。ほかの例は 設定ガイド にあります。

起動時にスキルを読み込む

そのセッションで使いたいスキルが決まっているなら、起動時に渡してしまえます。

hermes -s hermes-agent-dev,github-auth
hermes chat -s github-pr-workflow -s github-auth

Hermes は、最初のやり取りが始まる前に、指定されたスキルをセッションのプロンプトに読み込みます。このフラグは対話モードでも単発クエリモードでも使えます。

スキルのスラッシュコマンド

~/.hermes/skills/ に入っているスキルは、すべて自動的にスラッシュコマンドとして登録されます。スキル名がそのままコマンド名になります。

/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/github-pr-workflow create a PR for the auth refactor

# Just the skill name loads it and lets the agent ask what you need:
/excalidraw

人格設定

あらかじめ用意された人格を指定して、エージェントの口調を変えられます。

/personality pirate
/personality kawaii
/personality concise

組み込みの人格には次のものがあります。helpful、concise、technical、creative、teacher、kawaii、catgirl、pirate、shakespeare、surfer、noir、uwu、philosopher、hype。

既定の状態（上書きなし）に戻すには /personality none を使います。default と neutral も同じ働きをします。

~/.hermes/config.yaml で独自の人格を定義することもできます。

personalities:
  helpful: "You are a helpful, friendly AI assistant."
  kawaii: "You are a kawaii assistant! Use cute expressions..."
  pirate: "Arrr! Ye be talkin' to Captain Hermes..."
  # Add your own!

複数行の入力

複数行のメッセージを書く方法は2つあります。

1. Alt+Enter、Ctrl+J、Shift+Enter — 改行を挿入します
2. バックスラッシュで継続 — 行末を \ で終えると次の行に続きます:

❯ Write a function that:\
  1. Takes a list of numbers\
  2. Returns the sum

Ctrl+J とバックスラッシュによる継続は既定で有効で、Claude Code / Codex / OpenCode の複数行ショートカットに合わせてあります。iTerm2 などの対応ターミナルでは、Shift+Enter が独立した改行キーとして届くよう、Hermes が拡張キー通知も要求します。素の Enter で LF を送るターミナルを使っていて、従来どおり Ctrl+J を送信キーとして使いたい場合は、次の設定で無効にできます。

# ~/.hermes/config.yaml
display:
  cli_multiline_shortcuts: false

Shift+Enter の対応状況

多くのターミナルは、既定では Enter と Shift+Enter に同じバイト列を送るため、アプリケーション側では区別できません。Hermes が Shift+Enter を認識できるのは、ターミナルが Kitty キーボードプロトコル または xterm の modifyOtherKeys モードで別のシーケンスを送る場合だけです。

区別できないターミナルでも、Alt+Enter と Ctrl+J は既定で使えます。とくに Windows Terminal では、Alt+Enter がターミナル側に取られてしまい（全画面の切り替え）Hermes まで届きません。改行には Ctrl+Enter（Ctrl+J として届きます）か Ctrl+J を直接使ってください。

作業中のエージェントに指示を出し直す

エージェントが動いている最中でも、新しいターンを始めずに訂正を送れます。

• 新しいメッセージを打って Enter — その訂正で、進行中のターンの向きを変えます
• Ctrl+C — いまの処理を中断します（2秒以内に2回押すと強制終了）
• すでに終わったツールの作業や、表示済みの思考はコンテキストに残ります
• 実行中のツールは、安全に区切れるところまで進んでから訂正が適用されます

作業中の入力の扱い

display.busy_input_mode の設定は、エージェントが作業しているあいだに Enter を押したときの挙動を決めます。

# ~/.hermes/config.yaml
display:
  busy_input_mode: "steer"   # or "queue" or "interrupt" (default)

"queue" は、あとに続く別のターンを用意します。"steer" は常に次のツール結果の区切りを待ちます。既定の "interrupt" は、モデルが生成しているあいだなら早く反応しつつ、実行中のツールを打ち切らずに済みます。ターンとその手前の作業ごと取り消したいときは /stop を使ってください。知らない値を指定した場合は "interrupt" に戻ります。

"steer" には自動の逃げ道が2つあります。エージェントがまだ動き出していない場合と、画像が添付されている場合は、"queue" の挙動に切り替わり、内容が失われません。

CLI の中から切り替えることもできます。

/busy queue
/busy steer
/busy interrupt
/busy status

バックグラウンドへの退避

Unix 系のシステムでは、Ctrl+Z を押すと Hermes をバックグラウンドへ退避できます。ほかのターミナルのプロセスと同じです。シェルには次のように表示されます。

Hermes Agent has been suspended. Run `fg` to bring Hermes Agent back.

シェルで fg と打てば、中断したところからそのまま再開します。Windows では使えません。

ツールの進行表示

CLI は、エージェントが作業しているあいだ、動きのあるフィードバックを表示します。

考え中のアニメーション（API 呼び出し中）:

  ◜ (｡•́︿•̀｡) pondering... (1.2s)
  ◠ (⊙_⊙) contemplating... (2.4s)
  ✧٩(ˊᗜˋ*)و✧ got it! (3.1s)

ツール実行の流れ:

  ┊ 💻 terminal `ls -la` (0.3s)
  ┊ 🔍 web_search (1.2s)
  ┊ 📄 web_extract (2.1s)

表示モードは /verbose で順に切り替わります: off → new → all → verbose。このコマンドはメッセージングのプラットフォーム向けにも有効にできます。設定 を参照してください。

ツールのプレビュー長

display.tool_preview_length の設定は、ツール呼び出しのプレビュー行（ファイルパスやターミナルのコマンドなど）に表示する最大文字数を決めます。既定は 0 で、上限なしを意味します。パスもコマンドも省略されずに表示されます。

# ~/.hermes/config.yaml
display:
  tool_preview_length: 80   # Truncate tool previews to 80 chars (0 = no limit)

幅の狭いターミナルを使うときや、ツールの引数にとても長いファイルパスが入るときに役立ちます。

セッションの管理

セッションを再開する

CLI のセッションを終了すると、再開用のコマンドが表示されます。

Resume this session with:
  hermes --resume 20260225_143052_a1b2c3

Session:        20260225_143052_a1b2c3
Duration:       12m 34s
Messages:       28 (5 user, 18 tool calls)

再開の選択肢は次のとおりです。

hermes --continue                          # Resume the most recent CLI session
hermes -c                                  # Short form
hermes -c "my project"                     # Resume a named session (latest in lineage)
hermes --resume 20260225_143052_a1b2c3     # Resume a specific session by ID
hermes --resume "refactoring auth"         # Resume by title
hermes --resume latest                     # Resume the most recent session (same as -c)
hermes --resume latest --in ./my-project   # Latest session for ./my-project's workspace
hermes -r 20260225_143052_a1b2c3           # Short form

再開すると、会話の履歴が SQLite から丸ごと復元されます。エージェントは、これまでのメッセージ、ツール呼び出し、応答をすべて見られる状態になります。席を外していなかったのと同じです。

チャットの中で /title My Session Name と打つと、現在のセッションに名前を付けられます。コマンドラインからなら hermes sessions rename <id> <title> です。過去のセッションを見て回るには hermes sessions list を使います。

セッションの保存先

CLI のセッションは、Hermes の SQLite 状態データベース ~/.hermes/state.db に保存されます。このデータベースが持っているのは次のものです。

• セッションのメタデータ（ID、名前、時刻、トークンのカウンタ）
• メッセージの履歴
• 圧縮や再開をまたいだ系譜
• session_search が使う全文検索の索引

メッセージング用のアダプターの中には、データベースとは別にプラットフォームごとの記録ファイルを持つものもありますが、CLI 自身は SQLite のセッションストアから再開します。

コンテキストの圧縮

長い会話は、コンテキストの上限に近づくと自動的に要約されます。

# In ~/.hermes/config.yaml
compression:
  enabled: true
  threshold: 0.50    # Compress at 50% of context limit by default

# Summarization model configured under auxiliary:
auxiliary:
  compression:
    model: ""  # Leave empty to use the main chat model (default). Or pin a cheap fast model, e.g. "google/gemini-3-flash-preview".

圧縮が働くと、途中のやり取りが要約されます。最初の3ターンと最後の20ターンは常にそのまま残ります。

バックグラウンドのセッション

CLI で別の作業を続けながら、プロンプトを別のバックグラウンドセッションで走らせられます。

/bg Analyze the logs in /var/log and summarize any errors from today

Hermes はすぐに受け付けを知らせ、入力欄を返してくれます。

🔄 Background task #1 started: "Analyze the logs in /var/log and summarize..."
   Task ID: bg_143022_a1b2c3

仕組み

/bg のプロンプトはそれぞれ、デーモンスレッド上に 完全に独立したエージェントのセッション を立ち上げます。

• 会話は独立 — バックグラウンドのエージェントは、いまのセッションの履歴を一切知りません。受け取るのは渡したプロンプトだけです。
• 設定は同じ — バックグラウンドのエージェントは、いまのセッションのモデル、プロバイダー、ツールセット、推論の設定、フォールバックのモデルを引き継ぎます。
• 待たされない — 手元のセッションは完全に操作できるままです。チャットもコマンド実行も、さらに別のバックグラウンドタスクの開始もできます。
• 複数同時に — バックグラウンドタスクは同時にいくつも動かせます。それぞれに番号付きの ID が付きます。

結果

バックグラウンドのタスクが終わると、結果がターミナルにパネルとして現れます。

╭─ ⚕ Hermes (background #1) ──────────────────────────────────╮
│ Found 3 errors in syslog from today:                         │
│ 1. OOM killer invoked at 03:22 — killed process nginx        │
│ 2. Disk I/O error on /dev/sda1 at 07:15                      │
│ 3. Failed SSH login attempts from 192.168.1.50 at 14:30      │
╰──────────────────────────────────────────────────────────────╯

タスクが失敗した場合は、代わりにエラーの通知が出ます。設定で display.bell_on_complete を有効にしていれば、タスクが終わったときにターミナルのベルが鳴ります。

使いどころ

• 時間のかかる調べもの — コードを書きながら「/bg research the latest developments in quantum error correction」
• ファイルの処理 — 会話を続けながら「/bg analyze all Python files in this repo and list any security issues」
• 並行した切り分け — 複数のバックグラウンドタスクを立てて、別々の角度から同時に探る

静かなモード

CLI は既定で静かなモードで動きます。このモードでは次のようになります。

• ツールからの詳細なログを抑えます
• kawaii 風の動きのあるフィードバックを表示します
• 出力をすっきりと読みやすく保ちます

デバッグ出力が必要なときは次を実行します。

hermes chat --verbose