プロファイル: 複数のエージェントを動かす
目次
同じマシンの上で、独立した Hermes のエージェントをいくつも動かせます。設定、API キー、記憶、セッション、スキル、ゲートウェイの状態は、それぞれ別々に持ちます。
プロファイルとは
プロファイルとは、Hermes のホームディレクトリを分けたものです。それぞれのプロファイルが自分のディレクトリを持ち、その中に config.yaml、.env、SOUL.md、記憶、セッション、スキル、cron ジョブ、状態のデータベースを持ちます。プロファイルを使えば、コーディングの相棒、個人用のボット、調べもの用のエージェントというように、目的の違うエージェントを Hermes の状態を混ぜずに動かせます。
プロファイルを作ると、そのプロファイルは自動的に 1 つのコマンドになります。coder という名前のプロファイルを作れば、その時点で coder chat、coder setup、coder gateway start などが使えるようになります。
すぐ使い始める
hermes profile create coder # creates profile + "coder" command alias
coder setup # configure API keys and model
coder chat # start chattingこれだけです。coder は、自分の設定・記憶・状態を持つ 1 つの Hermes のプロファイルになりました。
プロファイルを作る
空のプロファイル
hermes profile create mybot同梱のスキルだけを入れた、まっさらなプロファイルを作ります。mybot setup を実行して、API キー、モデル、ゲートウェイのトークンを設定してください。
このプロファイルをカンバンのワーカーとして使う予定があるなら（あるいはカンバンの取りまとめ役に仕事を振らせたいなら）、作るときに --description "<role>" を渡して、何が得意なのかを取りまとめ役に伝えておきます。
hermes profile create researcher --description "Reads source code and external docs, writes findings."説明はあとから hermes profile describe で設定したり、自動生成したりもできます。振り分けの仕組み全体は カンバンの手引き をご覧ください。
設定だけ複製する（--clone）
hermes profile create work --clone今のプロファイルの config.yaml、.env、SOUL.md、スキルを新しいプロファイルへコピーします。API キーもモデルもできることも同じで、セッションと記憶だけが新しくなります。API キーを変えたいときは ~/.hermes/profiles/work/.env を、人格を変えたいときは ~/.hermes/profiles/work/SOUL.md を編集してください。
まるごと複製する（--clone-all）
hermes profile create backup --clone-all設定、API キー、人格、すべての記憶、スキル、cron ジョブ、プラグインまですべてコピーします。動く状態がまるごと 1 つ手に入るということです。ただしプロファイルごとの履歴は除きます（セッションの履歴、state.db、backups/、state-snapshots/、checkpoints/）。これらは元のプロファイルのもので、数十 GB になることもあるからです。履歴まで含めた完全な控えが欲しいときは、代わりに hermes profile export か hermes backup を使ってください。
指定したプロファイルから複製する
hermes profile create work --clone-from coder--clone-from <source> は複製元のプロファイルを直接指定するもので、設定・スキル・SOUL の複製を含みます。その複製元をまるごとコピーしたいときは --clone-all と組み合わせます。
hermes profile create work-backup --clone-from coder --clone-allプロファイルを使う
コマンドの別名
どのプロファイルにも、~/.local/bin/<name> に自動でコマンドの別名が作られます。
coder chat # chat with the coder agent
coder setup # configure coder's settings
coder gateway start # start coder's gateway
coder doctor # check coder's health
coder skills list # list coder's skills
coder config set model.default anthropic/claude-sonnet-4この別名は hermes のすべてのサブコマンドで使えます。中身は hermes -p <name> そのものだからです。
-p フラグ
どのコマンドでも、対象のプロファイルを明示的に指定できます。
hermes -p coder chat
hermes --profile=coder doctor
hermes chat -p coder -q "hello" # works in any position既定を固定する（hermes profile use）
hermes profile use coder
hermes chat # now targets coder
hermes tools # configures coder's tools
hermes profile use default # switch back既定を設定して、素の hermes コマンドがそのプロファイルを対象にするようにします。kubectl config use-context と同じ感覚です。
今どこにいるかを知る
CLI は、どのプロファイルが有効かを常に表示します。
- プロンプト:
❯ではなくcoder ❯になります - バナー: 起動時に
Profile: coderと表示します hermes profile: 今のプロファイル名、パス、モデル、ゲートウェイの状態を表示します
プロファイルとワークスペースとサンドボックスの違い
プロファイルはワークスペースやサンドボックスと混同されがちですが、別のものです。
- プロファイルは、Hermes に専用の状態ディレクトリを与えます。
config.yaml、.env、SOUL.md、セッション、記憶、ログ、cron ジョブ、ゲートウェイの状態が入ります。 - ワークスペース、つまり作業ディレクトリは、ターミナルのコマンドが始まる場所です。これは
terminal.cwdで別に決めます。 - サンドボックスは、ファイルへのアクセスを制限する仕組みです。プロファイルはエージェントを閉じ込めません。
既定の local ターミナルバックエンドでは、エージェントはあなたのユーザーアカウントと同じだけファイルにアクセスできます。プロファイルのディレクトリの外にあるフォルダを触るのを、プロファイルが止めてくれるわけではありません。
あるプロファイルを特定のプロジェクトのフォルダから始めたいなら、そのプロファイルの config.yaml に terminal.cwd を絶対パスで明示してください。
terminal:
backend: local
cwd: /absolute/path/to/projectlocal バックエンドで cwd: "." と書いた場合、それは「Hermes を起動したディレクトリ」であって「プロファイルのディレクトリ」ではありません。
あわせて次の点にも注意してください。
SOUL.mdはモデルへの指針にはなりますが、作業範囲の境界を強制するものではありません。SOUL.mdの変更は、新しいセッションからきれいに効きます。すでに動いているセッションは、古いプロンプトのままのことがあります。- モデルに「今どのディレクトリにいますか」と尋ねても、隔離の確認にはなりません。ツールの開始位置を確実に決めたいなら、
terminal.cwdを明示してください。
ゲートウェイを動かす
プロファイルはそれぞれ、自分のボットトークンを持つ別プロセスとして、自分のゲートウェイを動かします。
coder gateway start # starts coder's gateway
assistant gateway start # starts assistant's gateway (separate process)ボットトークンを分ける
プロファイルごとに .env ファイルがあります。Telegram / Discord / Slack のボットトークンを、それぞれ別に設定してください。
# Edit coder's tokens
nano ~/.hermes/profiles/coder/.env
# Edit assistant's tokens
nano ~/.hermes/profiles/assistant/.env安全対策: トークンのロック
2 つのプロファイルがうっかり同じボットトークンを使った場合、2 つ目のゲートウェイは起動を止められ、どのプロファイルとぶつかっているかが分かるエラーが出ます。Telegram、Discord、Slack、WhatsApp、Signal で対応しています。
常駐サービスにする
coder gateway install # creates hermes-gateway-coder systemd/launchd service
assistant gateway install # creates hermes-gateway-assistant serviceプロファイルごとに別のサービス名が付き、それぞれ独立して動きます。
プロファイルを設定する
プロファイルはそれぞれ次のものを持ちます。
config.yaml— モデル、プロバイダー、ツールセット、その他すべての設定.env— API キー、ボットのトークンSOUL.md— 人格と指示
coder config set model.default anthropic/claude-sonnet-4
echo "You are a focused coding assistant." > ~/.hermes/profiles/coder/SOUL.mdこのプロファイルを既定で特定のプロジェクトで働かせたいなら、そのプロファイルの terminal.cwd も設定してください。
coder config set terminal.cwd /absolute/path/to/projectダッシュボードから設定する
Web ダッシュボード はマシン全体を見る画面で、サイドバーのプロファイル切り替えからどのプロファイルの 設定、API キー、スキル、MCP、モデルでも扱えます。プロファイルごとに ダッシュボードを立てる必要はありません。coder dashboard を実行すると、 coder プロファイルを選んだ状態でマシン全体のダッシュボードが開きます。 ダッシュボードの Chat タブもこの切り替えに従い、選んでいるプロファイルの ホームの下で会話を始めます。
なお、ダッシュボードの Profiles ページにある「Set as active」は、これから動かす CLI やゲートウェイの既定を固定するものです（hermes profile use と同じです）。 ダッシュボードからプロファイルを編集したいときは、切り替えのほうを使ってください。
更新する
hermes update はコードを 1 回だけ取得し（共有です）、同梱スキルの追加分をすべてのプロファイルへ自動で反映します。
hermes update
# → Code updated (12 commits)
# → Skills synced: default (up to date), coder (+2 new), assistant (+2 new)自分で手を入れたスキルが上書きされることはありません。
プロファイルを管理する
hermes profile list # show all profiles with status
hermes profile show coder # detailed info for one profile
hermes profile rename coder dev-bot # rename (updates alias + service)
hermes profile export coder # pack into coder.tar.gz (shareable; keys stripped)
hermes profile import coder.tar.gz # install an archive as a new profileチャットの中では、この 2 つは /export と /import として使えます。デスクトップアプリなら ⌘K → Export/Import profile… です。プロファイルを渡す をご覧ください。
既定のプロファイルに名前を付ける
既定のプロファイルの内部 ID は常に default です。~/.hermes が インストールの土台そのものなので、本当の意味では改名できません。 改名すると代わりに表示名が設定され、画面上ではむき出しの ID の代わりに そちらが出ます。
hermes profile rename default Harumesu # Unicode fine: 小助手表示名が出るのは、hermes profile list / show、チャットの /profile コマンド、ダッシュボード、デスクトップアプリ（Bot モードの一覧を含む）です。 これは見た目だけの話で、-p default、サービス名、cron ジョブなど、 それ以外の参照はすべて正規の default という ID を使い続けます。表示名は ~/.hermes/profile.yaml に display_name として保存されるので、 元に戻したいときはその行を消してください。名前付きのプロファイルにも display_name を持たせられますが（本当の改名をしても残ります）、そちらの rename はプロファイル自体の名前を変えます。
プロファイルを削除する
hermes profile delete coderゲートウェイを止め、systemd / launchd のサービスを消し、コマンドの別名を消し、プロファイルのデータをすべて削除します。確認のため、プロファイル名の入力を求められます。
確認を飛ばしたいときは --yes を使います: hermes profile delete coder --yes
タブ補完
# Bash
eval "$(hermes completion bash)"
# Zsh
eval "$(hermes completion zsh)"この行を ~/.bashrc か ~/.zshrc に足しておけば、補完がずっと効きます。-p のあとのプロファイル名、profile のサブコマンド、最上位のコマンドが補完されます。
仕組み
プロファイルは HERMES_HOME という環境変数を使っています。coder chat を実行すると、ラッパースクリプトが hermes を起動する前に HERMES_HOME=~/.hermes/profiles/coder を設定します。コードベースの 119 以上のファイルが get_hermes_home() を通してパスを解決しているので、Hermes の状態は自動的にそのプロファイルのディレクトリに収まります。設定、セッション、記憶、スキル、状態のデータベース、ゲートウェイの PID、ログ、cron ジョブがそうです。
これは、ターミナルの作業ディレクトリとは別の話です。ツールの実行は terminal.cwd（local バックエンドで cwd: "." の場合は起動したディレクトリ）から始まるのであって、自動的に HERMES_HOME から始まるわけではありません。
ホストに直接入れた場合、ツールのサブプロセスは既定であなたの本来の OS ユーザーの HOME を保ちます。~ の下にある既存の CLI の認証情報が、プロファイルをまたいでも そのまま使えるようにするためです。プロファイルのデータは HERMES_HOME で 分けられているのであって、HOME を変えて分けているのではありません。コンテナ側の バックエンドは、ツールの状態を残すのに引き続き {HERMES_HOME}/home を使います。 ホストでもプロファイルごとに厳密にツールの設定を分けたい人は、 terminal.home_mode: profile で切り替えられます。
ここには、混同しやすい 2 つの話が含まれています。
HERMES_HOMEはプロファイルの境界です。Hermes の設定、.env、
記憶、セッション、スキル、ログ、cron ジョブ、ゲートウェイの状態など、Hermes の データを決めます。
HOMEは、外部の CLI が期待する OS 上のユーザーのホームです。ホストに
直接入れた場合、Hermes は既定でこれを本来のユーザーのホームのままにするので、 git、ssh、gh、az、npm、Claude Code、Codex といったツールが、普段の シェルと同じ認証情報を見つけられます。
その代わり、ホストのプロファイルは既定でユーザー単位の CLI の状態を共有します。 プロファイルごとに CLI の身元を分けたいなら、そのプロファイルの config.yaml に terminal.home_mode: profile を設定してください。このモードでは、Hermes はツールのサブプロセスを HOME={HERMES_HOME}/home で起動します。そのプロファイルのホームの中に、 ~/.ssh、~/.gitconfig、~/.config/gh、クラウド CLI の認証、Claude や Codex の認証、 npm の状態などを、自分で用意するかリンクする必要があります。
Hermes は HERMES_REAL_HOME もサブプロセスへ渡すので、home_mode: profile が 効いているときでも、スクリプトから本当のアカウントのホームを見つけられます。
既定のプロファイルとは、~/.hermes そのもののことです。移行作業は要りません。すでに入っている環境は、これまでどおりに動きます。
プロファイルを渡す
1 台のマシンで育てたプロファイルは、別の場所へ持っていけます。自分のもう 1 台の作業機でも、同僚のノート PC でも、コミュニティでも構いません。方法は 2 つあります。
ファイルを送る。 /export は、スキル、記憶、人格、cron、プラグイン、設定、そしてデスクトップからならテーマとレイアウトまで、プロファイルを 1 つの .tar.gz にまとめます。API キーは取り除かれます。受け取った側は /import を実行します。
# In chat, run /export, hand over the file, and they run /import on it
hermes profile export coder
hermes profile import ./coder.tar.gz --name coder配布物として公開する。 プロファイルを git リポジトリとして仕立てれば、受け取る側はコマンド 1 つで入れられ、あとから版を追って更新もできます。SOUL、設定、スキル、cron ジョブ、MCP の接続を運びます。認証情報、記憶、セッションはマシンごとのままです。
# Install a whole agent from a git repo
hermes profile install github.com/you/research-bot --alias
# Update later when the author ships a new version (keeps your memories + .env)
hermes profile update research-bot1 回きりの受け渡しや引っ越しには書き出したファイルを、これからも更新を届けていくエージェントには配布物を使ってください。どちらについても、比較の表、作り方、公開の仕方、更新の考え方、安全性の考え方までを プロファイルの配布: エージェントをまるごと渡す にまとめてあります。