jpskill.com
🛠️ 開発・MCP コミュニティ

hcom-agent-messaging

AIエージェントがターミナルを介して互いにメッセージを送り、監視し、生成し合うことを可能にし、hcomの設定方法やトラブルシューティングなど、hcomに関するユーザーの質問やヘルプ要求に対応するSkill。

📜 元の英語説明(参考)

Let AI agents message, watch, and spawn each other across terminals. Claude Code, Gemini CLI, Codex, OpenCode. Use this skill when the human user needs help, status, or reference about hcom - when user asks questions like "how to setup hcom", "hcom not working", "explain hcom", or any hcom troubleshooting.

🇯🇵 日本人クリエイター向け解説

一言でいうと

AIエージェントがターミナルを介して互いにメッセージを送り、監視し、生成し合うことを可能にし、hcomの設定方法やトラブルシューティングなど、hcomに関するユーザーの質問やヘルプ要求に対応するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o hcom-agent-messaging.zip https://jpskill.com/download/8636.zip && unzip -o hcom-agent-messaging.zip && rm hcom-agent-messaging.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/8636.zip -OutFile "$d\hcom-agent-messaging.zip"; Expand-Archive "$d\hcom-agent-messaging.zip" -DestinationPath $d -Force; ri "$d\hcom-agent-messaging.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して hcom-agent-messaging.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → hcom-agent-messaging フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

hcom — ターミナル間で AI エージェントがメッセージを送り、監視し、互いを生成できるようにします。Claude Code, Gemini CLI, Codex, OpenCode。

別々のターミナルで実行されている AI エージェントは互いに隔離されています。コンテキストは引き継がれず、決定が繰り返され、ファイルの編集が衝突します。hcom はそれらを接続します。

pip install hcom
hcom claude
hcom gemini
hcom codex
hcom opencode
hcom                            # TUI ダッシュボード

人間ができること

任意のエージェントに指示します。

claude にメッセージを送る

codex がアイドル状態になったら、次のタスクを送る

gemini のファイル編集を監視し、それぞれをレビューし、バグがあればフィードバックを送る

自分自身をフォークしてバグを調査し、報告する

terminal_id コードを誰が担当したかを見つけ、再開させて、なぜそれがひどいのか尋ねる

エージェントができること

  • 互いにメッセージを送る (@メンション、インテント、スレッド、ブロードキャスト)
  • 互いのトランスクリプトを読む (範囲、詳細レベル)
  • エージェントのターミナル画面を表示し、承認のためにテキスト/エンターを挿入する
  • イベント履歴をクエリする (ファイル編集、コマンド、ステータス、ライフサイクル)
  • 互いのアクティビティをリアルタイムで購読し、反応する
  • 新しいターミナルペインでエージェントを生成、フォーク、再開、強制終了する
  • ハンドオフ用のコンテキストバンドル (ファイル、トランスクリプト、イベント) を構築する
  • 衝突検出 — 2 つのエージェントが 20 秒以内に同じファイルを編集した場合、両方に通知される
  • クロスデバイス — MQTT リレーを介してマシン間でエージェントを接続する

セットアップ

ユーザーが引数なしでこのスキルを呼び出した場合:

  1. hcom status を実行します — 「command not found」の場合は、最初に pip install hcom を実行します
  2. 新しいターミナルで hcom claude または hcom gemini または hcom codex または hcom opencode を実行するようにユーザーに指示します (初回実行時にフックが自動的にインストールされます)
ステータス出力 意味 アクション
command not found hcom がインストールされていません pip install hcom
[~] claude ツールは存在するが、フックがインストールされていません hcom hooks add を実行してからツールを再起動します (または hcom claude を実行します)
[✓] claude フックがインストールされました 準備完了 — hcom claude または hcom start を使用します
[✗] claude ツールが見つかりません 最初に AI ツールをインストールします

フックを追加または hcom をインストールした後、hcom をアクティブにするには、現在の AI ツールを再起動する必要があります。

ツールサポート

ツール メッセージ配信
Claude Code (サブエージェントを含む) 自動
Gemini CLI 自動
Codex 自動
OpenCode 自動
任意の AI ツール 手動 - hcom start 経由

トラブルシューティング

「hcom が動作しない」

hcom status          # インストールを確認
hcom hooks status    # 特にフックを確認
hcom daemon status
hcom relay status

フックが見つかりませんか? hcom hooks add を実行してからツールを再起動します。

まだ壊れていますか?

hcom reset all && hcom hooks add
# すべての claude/codex/gemini/opencode/hcom ウィンドウを閉じます
hcom claude          # 新規スタート

「メッセージが届かない」

  1. 受信者を確認: hcom list — 彼らは listening または active ですか?
  2. 送信されたメッセージを確認: hcom events --sql "type='message'" --last 5
  3. *受信者が `[claude]` と表示されていますか?** AI ツールを再起動します

サンドボックス / 権限の問題

export HCOM_DIR="$PWD/.hcom"     # プロジェクトローカルモード
hcom hooks add                   # プロジェクトディレクトリにインストール

ファイル

内容 場所
データベース ~/.hcom/hcom.db
設定 ~/.hcom/config.toml
ログ ~/.hcom/.tmp/logs/hcom.log

HCOM_DIR が設定されている場合、~/.hcom の代わりにそのパスを使用します。

詳細情報

hcom --help              # すべてのコマンド
hcom <command> --help    # コマンドの詳細
hcom run docs            # 完全な CLI + 設定 + API リファレンス

GitHub: https://github.com/aannoo/hcom

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

hcom — Let AI agents message, watch, and spawn each other across terminals. Claude Code, Gemini CLI, Codex, OpenCode.

AI agents running in separate terminals are isolated from each other. Context doesn't transfer, decisions get repeated, file edits collide. hcom connects them.

pip install hcom
hcom claude
hcom gemini
hcom codex
hcom opencode
hcom                            # TUI dashboard

What humans can do

Tell any agent:

send a message to claude

when codex goes idle send it the next task

watch gemini's file edits, review each and send feedback if any bugs

fork yourself to investigate the bug and report back

find which agent worked on terminal_id code, resume them and ask why it sucks

What agents can do

  • Message each other (@mentions, intents, threads, broadcast)
  • Read each other's transcripts (ranges, detail levels)
  • View agent terminal screens, inject text/enter for approvals
  • Query event history (file edits, commands, status, lifecycle)
  • Subscribe and react to each other's activity in real-time
  • Spawn, fork, resume, kill agents in new terminal panes
  • Build context bundles (files, transcript, events) for handoffs
  • Collision detection — 2 agents edit same file within 20s, both notified
  • Cross-device — connect agents across machines via MQTT relay

Setup

If the user invokes this skill without arguments:

  1. Run hcom status — if "command not found", run pip install hcom first
  2. Tell user to run hcom claude or hcom gemini or hcom codex or hcom opencode in a new terminal (auto installs hooks on first run)
Status Output Meaning Action
command not found hcom not installed pip install hcom
[~] claude Tool exists, hooks not installed hcom hooks add then restart tool (or just hcom claude)
[✓] claude Hooks installed Ready — use hcom claude or hcom start
[✗] claude Tool not found Install the AI tool first

After adding hooks or installing hcom you must restart the current AI tool for hcom to activate.

Tool Support

Tool Message Delivery
Claude Code (incl. subagents) automatic
Gemini CLI automatic
Codex automatic
OpenCode automatic
Any AI tool manual - via hcom start

Troubleshooting

"hcom not working"

hcom status          # Check installation
hcom hooks status    # Check hooks specifically
hcom daemon status
hcom relay status

Hooks missing? hcom hooks add then restart tool.

Still broken?

hcom reset all && hcom hooks add
# Close all claude/codex/gemini/opencode/hcom windows
hcom claude          # Fresh start

"messages not arriving"

  1. Check recipient: hcom list — are they listening or active?
  2. Check message sent: hcom events --sql "type='message'" --last 5
  3. *Recipient shows `[claude]`?** Restart the AI tool

Sandbox / Permission Issues

export HCOM_DIR="$PWD/.hcom"     # Project-local mode
hcom hooks add                   # Installs to project dir

Files

What Location
Database ~/.hcom/hcom.db
Config ~/.hcom/config.toml
Logs ~/.hcom/.tmp/logs/hcom.log

With HCOM_DIR set, uses that path instead of ~/.hcom.

More Info

hcom --help              # All commands
hcom <command> --help    # Command details
hcom run docs            # Full CLI + config + API reference

GitHub: https://github.com/aannoo/hcom