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

hcom

Claude Code、Gemini CLI、Codexにおける複数エージェント間のコミュニケーションや連携をサポートし、hcomの設定方法、動作不良、詳細説明、トラブルシューティングなど、ユーザーがhcomに関するヘルプや状況確認を必要とする際に活用できるSkill。

📜 元の英語説明(参考)

multi-agent communication and coordination for Claude Code, Gemini CLI & Codex. 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.

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

一言でいうと

Claude Code、Gemini CLI、Codexにおける複数エージェント間のコミュニケーションや連携をサポートし、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.zip https://jpskill.com/download/8637.zip && unzip -o hcom.zip && rm hcom.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/8637.zip -OutFile "$d\hcom.zip"; Expand-Archive "$d\hcom.zip" -DestinationPath $d -Force; ri "$d\hcom.zip"

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

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して hcom.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → hcom フォルダができる
  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コーディングエージェントのためのリアルタイムメッセージング + コンテキスト共有

hcomとは？

ローカルメッセージバス + イベントログです。エージェント同士がメッセージを送り合い、トランスクリプトを共有し、イベントに関する通知を受け取り、新しいエージェントを生成します。メッセージは、エージェントがアクティブなときもアイドル状態のときも届きます。

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

特徴

メッセージング - 全員に送信、または特定の@エージェントにメンション hcom send --help

トランスクリプト - 他のエージェントの会話履歴を読み取る hcom transcript --help

サブスクリプション - イベントが一致したときに通知を受け取る（リアルタイムのファイル衝突、エージェントのアイドル状態、シェルコマンド） hcom events --help

生成 - 新しいターミナルにエージェントを起動 hcom 3 claude | HCOM_TAG=team hcom 2 gemini (グループ) | hcom claude -p "task" (ヘッドレス)

ワークフロースクリプト - 事前に構築されたワークフロー（バックグラウンドレビューア、ディベート、クローン、アンサンブル） hcom run --help

クロスデバイス - HuggingFaceリレーを介してマシン間でエージェントを接続 hcom relay --help

設定 - ターミナル、タグ、ヒント、タイムアウト hcom config | hcom config terminal --info (任意のターミナルを設定)

クイックセットアップ

現在の状態を確認:

hcom status
出力 意味 アクション
[~] claude ツールは存在するが、フックがインストールされていない hcom hooks add を実行してからツールを再起動
[✓] claude フックがインストール済み 準備完了 - hcom claude または hcom start を使用
[✗] claude ツールが見つからない 最初にAIツールをインストール

hcom hooks add の後: フックを有効にするには、AIツールを必ず再起動する必要があります。

参加状況の確認:

hcom list
ツールの表示 意味
[CLAUDE] フル機能（hcom claude 経由で起動）
[claude] フックのみのモード（通常の hcom start）
[claude*] アドホックモード - フル機能を利用するにはAIツールを再起動してください

[GEMINI]/[gemini]/[gemini*] および [CODEX]/[codex]/[codex*] でも同様のパターンです。

アスタリスク * は、このセッションでフックがアクティブでないことを意味します。AIツールを閉じて再度開いてください。

hcomの起動

オプションA - hcomで起動（推奨）:

hcom claude       # または: hcom gemini, hcom codex

オプションB - 既存のセッションに接続:

hcom start を実行

hcomの使用

メッセージを送信: エージェントに自然に話しかける - "geminiにテストを確認するようにメッセージを送って"

TUIダッシュボード: hcom (引数なし) - イベントストリーム、ブロードキャスト、ステータス、起動

トラブルシューティング

"hcomが動作しない"

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

フックが見つからない？ hcom hooks add を実行してからツールを再起動してください。

それでも壊れている？

hcom reset all && hcom hooks add
# すべての claude/codex/gemini/hcom ウィンドウを閉じる
hcom claude          # 新規起動

"メッセージが届かない"

  1. 受信者を確認: hcom list - listening または active になっていますか？
  2. 送信されたメッセージを確認: hcom events --sql "type='message'" --last 5
  3. TUIを確認 - 配信を妨げるものを表示します:
    • エージェントが処理中（リスニングしていない）
    • ユーザーが入力中（配信が一時停止）
    • プロンプトにコミットされていないテキストがある
    • ツールがサブメニューにある/プロンプトにない
  4. *受信者が `[claude]` と表示されている？** AIツールを再起動する必要があります

"identity not found"

最初に hcom start を実行するか、hcom claude を使用して自動的にIDを設定して起動します。

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

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

新規起動

hcom reset all # データベースのアーカイブ、設定のリセット、フックの削除、すべてのエージェントの停止
pip uninstall hcom && pip install hcom
# AIツールを再起動

ツールのサポート

ツール メッセージ配信 注記
Claude Code アイドル + ターン中 フルフック、サブエージェントが動作
Gemini CLI (v0.24.0+) アイドル + ターン中 フルフック
Codex アイドル + hcom listen 1つのフック
任意のAIツール 手動 hcom start によるアドホックモード

ファイル

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

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

アーカイブとリセット

hcom reset はデータベースをアーカイブし、新たに開始します。AIツールの /clear と同様です。

  • インタラクティブなエージェントは「停止」されますが、ターミナルは開いたままです - hcom start --as NAME で再利用できます
  • ヘッドレスエージェントは強制終了されます

アーカイブのクエリ:

hcom archive            # リスト表示 (最小 = 最新)
hcom archive 1          # 最新のクエリ

hcomの削除

hcom hooks remove # すべてのツール設定ファイルから、hcomのフック/設定のみを安全に削除

詳細情報

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

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

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

hcom — realtime messaging + context sharing for AI coding agents

What is hcom?

Local message bus + event log. Agents message each other, share transcripts, get notified on events, and spawn new agents. Messages arive when agents are active and idle.

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

Features

Messaging - send to all or @mention specific agents hcom send --help

Transcripts - read other agent's conversation history hcom transcript --help

Subscriptions - get notified when events match (real-time file collisions, agent idle, shell commands) hcom events --help

Spawn - launch agents into new terminals hcom 3 claude | HCOM_TAG=team hcom 2 gemini (group) | hcom claude -p "task" (headless)

Workflow Scripts - pre-built workflows (background reviewer, debate, clone, ensemble) hcom run --help

Cross-device - connect agents across machines via HuggingFace relay hcom relay --help

Config - terminal, tags, hints, timeouts hcom config | hcom config terminal --info (set any terminal)

Quick Setup

Check current state:

hcom status
Output Meaning Action
[~] claude Tool exists, hooks not installed hcom hooks add then restart tool
[✓] claude Hooks installed Ready - use hcom claude or hcom start
[✗] claude Tool not found Install the AI tool first

After hcom hooks add: You MUST restart your AI tool for hooks to activate.

Verify participation:

hcom list
Tool Display Meaning
[CLAUDE] Full features (launched via hcom claude)
[claude] Hooks-only mode (vanilla hcom start)
[claude*] Ad-hoc mode - restart AI tool for full features

Same pattern for [GEMINI]/[gemini]/[gemini*] and [CODEX]/[codex]/[codex*].

The asterisk * means hooks aren't active for this session. Close and reopen the AI tool.

Starting hcom

Option A - Launch with hcom (recommended):

hcom claude       # or: hcom gemini, hcom codex

Option B - Connect existing session:

Run hcom start

Using hcom

Send messages: Talk to agents naturally - "send a message to gemini saying check the tests"

TUI dashboard: hcom (no args) - event stream, broadcast, status, launch

Troubleshooting

"hcom not working"

hcom status          # Check installation
hcom hooks status    # Check hooks specifically

Hooks missing? hcom hooks add then restart tool.

Still broken?

hcom reset all && hcom hooks add
# Close all claude/codex/gemini/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. Check TUI - shows delivery blockers:
    • Agent processing (not listening)
    • User typing (delivery pauses)
    • Uncommitted text in prompt
    • Tool in submenu/not at prompt
  4. *Recipient shows `[claude]`?** They need to restart their AI tool

"identity not found"

Run hcom start first, or use hcom claude to launch with automatic identity.

Sandbox / Permission Issues

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

Fresh Start

hcom reset all # arhive db, reset config, remove hooks, stop all agents
pip uninstall hcom && pip install hcom
# Restart AI tool

Tool Support

Tool Message Delivery Notes
Claude Code idle + mid-turn Full hooks, subagents work
Gemini CLI (v0.24.0+) idle + mid-turn Full hooks
Codex idle + hcom listen 1 hook
Any AI tool manual Ad-hoc mode via hcom start

Files

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

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

Archives & Reset

hcom reset archives the database and starts fresh. Similar to /clear in AI tools.

  • Interactive agents get "stopped" but terminal stays open - can reclaim with hcom start --as NAME
  • Headless agents get killed

Query archives:

hcom archive            # List (lowest = most recent)
hcom archive 1          # Query most recent

Remove hcom

hcom hooks remove # Safely remove only hcom hooks/config from all tool settings files

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