Hermes Agent: CLIコマンドライン

最終更新:2026-08-31

CLIはHermes Agentの最も強力な操作方法です。すべての機能をコマンドラインから実行でき、スクリプト統合、バッチ操作、自動化パイプラインをサポートします。

💡 ヒント: CLIは開発者にとって最も効率的なHermesの使い方です。デスクトップ版とWeb版は80%の機能をカバー、CLIは100%をカバーします。自動化シナリオではCLIが必須。

📋 前提知識: 第2課 インストール、第3課 設定ファイル

1. 学ぶ内容

# 内容
CLIコマンド総覧
コアコマンドの詳細
会話とインタラクションコマンド
管理と運用コマンド
スクリプト統合と自動化

2. ストーリー

(1) 課題:毎回手動操作が必要

Bobは毎日:Hermesを開く → モデルを切り替え → 会話を開始 → 結果を保存 → 通知を送信。5つの手動ステップ、面倒で忘れやすい。

(2) 解決策:1コマンドで完了

Aliceはスクリプトを書き、毎日自動実行:

BASH
#!/bin/bash
# daily-workflow.sh
hermes chat --model gpt-4o --skill daily-briefing --output report.md
hermes notify telegram --file report.md
hermes checkpoint save "daily-$(date +%Y%m%d)"

3. CLIコマンド総覧

(1) コマンド分類

カテゴリ コマンド 説明
コア hermes chat インタラクティブ会話
hermes serve APIサービス起動
hermes run 単一タスク実行
設定 hermes init 初期化
hermes config 設定管理
hermes model モデル管理
メモリ hermes memory メモリ管理
スキル hermes skill スキル管理
ツール hermes tool ツール管理
プラットフォーム hermes platform プラットフォーム管理
定期 hermes cron 定期タスク
チェックポイント hermes checkpoint チェックポイント管理
デリゲート hermes delegate デリゲートタスク
プラグイン hermes plugin プラグイン管理
ダッシュボード hermes dashboard データパネル
Profile hermes profile ユーザー設定

4. コアコマンドの詳細

(1) hermes chat

BASH
# 基本的な会話
hermes chat

# モデルの指定
hermes chat --model gpt-4o

# ユーザーの指定
hermes chat --user alice

# スキルの指定
hermes chat --skill code-review

# 非インタラクティブモード(単一入力)
hermes chat --message "src/main.pyをレビュー" --no-interactive

# パイプ入力
cat error.log | hermes chat --message "このエラーログを分析して"

# ツールセットの指定
hermes chat --toolset frontend-dev

# ファイルへの出力
hermes chat --output report.md

(2) hermes run

BASH
# 単一タスク実行
hermes run "React 19の新機能を検索してサマリーを生成"

# モデルとスキルの指定
hermes run --model gpt-4o --skill research "Vue 4の変化を調査"

# デリゲートモード
hermes run --delegate --max-sub-agents 3 "プロジェクト全体のコード品質をレビュー"

# 出力フォーマット
hermes run --format json "このAPIのレスポンスフォーマットを分析"

(3) hermes serve

BASH
# APIサービスの起動
hermes serve --host 0.0.0.0 --port 8080

# バックグラウンド実行
hermes serve --daemon

# 設定の指定
hermes serve --config /path/to/config.yaml

# 全プラットフォームを有効化
hermes serve --platforms telegram,discord,slack

5. 会話とインタラクションコマンド

(1) 会話内コマンド

hermes chatのインタラクティブモードで、/で始まるコマンド:

コマンド 機能
/learn <内容> エージェントに新スキルを教える
/remember <内容> メモリを保存
/forget <id> メモリを削除
/skill <名前> スキルを呼び出し
/model <名前> モデルを切り替え
/toolset <名前> ツールセットを切り替え
/profile <名前> ユーザーを切り替え
/checkpoint save <名前> チェックポイントを保存
/checkpoint restore <名前> チェックポイントをリカバリ
/delegate status デリゲート状態を確認
/honcho profile ユーザープロファイルを確認
/cost 現在のセッションコストを確認
/help ヘルプ
/exit 終了

(2) 会話ショートカットキー

ショートカット 機能
↑/↓ 履歴入力の閲覧
Tab コマンド/スキル/ツール名の自動補完
Ctrl+C 現在の操作を中断
Ctrl+D 会話を終了
Ctrl+L 画面クリア

6. 管理と運用コマンド

(1) 設定管理

BASH
# 設定の確認
hermes config show
hermes config get model.default
hermes config get memory.working_memory_limit

# 設定の変更
hermes config set model.default gpt-4o
hermes config set personality.tone professional

# 設定の検証
hermes config validate

# エクスポート/インポート
hermes config export > backup.yaml
hermes config import backup.yaml

# リセット
hermes config reset

(2) モデル管理

BASH
# 利用可能モデル一覧
hermes model list

# モデル接続テスト
hermes model test gpt-4o

# カスタムモデルの追加
hermes model add --name my-model --provider ollama

# モデル詳細の確認
hermes model info gpt-4o

(3) ヘルスチェック

BASH
# フルヘルスチェック
hermes doctor

# クイックチェック
hermes health

# バージョン確認
hermes --version

# システム情報確認
hermes info

7. スクリプト統合と自動化

(1) Shellスクリプト統合

BASH
#!/bin/bash
# CI/CD統合例

# 1. コードレビュー
hermes run --skill code-review --output review.md "PR #$PR_NUMBERをレビュー"

# 2. レビュー結果の確認
if grep -q "🔴 重大" review.md; then
  echo "重大な問題が発見されました。マージを阻止します"
  exit 1
fi

# 3. テスト実行
hermes run --skill test-runner "完全テストスイートを実行"

# 4. リリースノートの生成
hermes run --model gpt-4o --output CHANGELOG.md "git logからリリースノートを生成"

(2) Python統合

PYTHON
from hermes import HermesClient

client = HermesClient(base_url="http://localhost:8080")

# メッセージ送信
response = client.chat(
    message="このファイルのコード品質をレビュー",
    model="gpt-4o",
    files=["src/main.py"]
)

print(response.text)

# バッチ実行
results = client.batch_run([
    {"message": "React 19を検索", "model": "gpt-4o-mini"},
    {"message": "Vue 4を検索", "model": "gpt-4o-mini"},
    {"message": "Svelte 5を検索", "model": "gpt-4o-mini"},
])

for r in results:
    print(f"Task: {r.task}, Cost: ${r.cost:.4f}")

(3) Makefile統合

MAKEFILE
.PHONY: review test deploy

review:
	hermes run --skill code-review "修正された全ファイルをレビュー"

test:
	hermes run --skill test-runner "テストスイートを実行"

deploy: review test
	hermes run "staging環境にデプロイ"
	@echo "デプロイ完了"

❓ よくある質問

Q CLIはWindowsに対応していますか?
A はい。PowerShellとCMDで動作します。一部パイプ機能はWSL2でより良い体験が得られます。
Q コマンドのヘルプを確認するには?
A hermes --helpでグローバルヘルプ、hermes chat --helpでサブコマンドのヘルプを確認。
Q 非インタラクティブモードはどんなシーンに適していますか?
A スクリプト統合、CI/CD、定期タスク、バッチ処理。人の操作が不要な自動化シナリオ。
Q 複数タスクを並列実行するには?
A Shellのバックグラウンド実行hermes run ... &またはPythonのマルチスレッド。CLI自体も--delegateで並列対応。
Q CLIのログはどこにありますか?
A デフォルトは~/.hermes/logs/hermes chat --verboseでリアルタイムに詳細ログを表示。
Q CLIの問題をデバッグするには?
A hermes chat --debugでデバッグモードを有効化し、完全なツール呼び出しとモデルリクエストを出力。

📖 まとめ


📝 練習問題

  1. 基本(⭐): CLIを使って完全なフローを実行してください:初期化 → 会話 → チェックポイント保存 → コスト確認。
  2. 中級(⭐⭐): Shellスクリプトを作成し、hermes runでコードレビュー+テスト+レポート生成を自動化してください。
  3. 上級(⭐⭐⭐): Python HermesClientで自動化ワークフローを開発してください:毎日定時にGitログを取得 → 日报生成 → 通知送信、cronに統合。
Web-Tutorial.com

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

100%