https://github.com/yinsang0910-star/collab-cli
Universal collaboration protocol + CLI for multi-agent LLM teams — Claude Code, Reasonix, Codex, WorkBuddy, Cursor
https://github.com/yinsang0910-star/collab-cli
ai-agent claude-code cli codex collaboration cursor deepseek developer-tools llm mcp multi-agent npm-package open-source productivity project-management protocol reasonix task-management typescript workbuddy
Last synced: 8 days ago
JSON representation
Universal collaboration protocol + CLI for multi-agent LLM teams — Claude Code, Reasonix, Codex, WorkBuddy, Cursor
- Host: GitHub
- URL: https://github.com/yinsang0910-star/collab-cli
- Owner: yinsang0910-star
- Created: 2026-06-06T08:56:31.000Z (15 days ago)
- Default Branch: master
- Last Pushed: 2026-06-06T10:03:37.000Z (15 days ago)
- Last Synced: 2026-06-06T10:21:39.696Z (15 days ago)
- Topics: ai-agent, claude-code, cli, codex, collaboration, cursor, deepseek, developer-tools, llm, mcp, multi-agent, npm-package, open-source, productivity, project-management, protocol, reasonix, task-management, typescript, workbuddy
- Language: JavaScript
- Size: 82 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.ja.md
Awesome Lists containing this project
README
🤝 collab-cli
クロスデバイス AIエージェント協働 + 記憶共有
異なるPC上の複数AIエージェントが、一つのチームのように働く — コンテキスト共有、直接コマンド、自動レビュー。
---
## 一言で言うと
> **異なるPCにAIエージェントがいますか？collab-cliはそれらを協働させます — 記憶を共有し、コマンドを送信し、お互いの仕事をレビュー。あなたがメッセンジャーになる必要はありません。**
## 4つのユニークな機能
### 1. 🌐 クロスデバイス協働
**異なるPC**上のエージェントがLAN経由で自動発見・リアルタイム同期。
```
PC A (192.168.1.100) PC B (192.168.1.101)
┌──────────────────────┐ ┌──────────────────────┐
│ Codex-1 │ UDP自動 │ Codex-2 │
│ collab node :9527 │◄──発見──────►│ collab node :9527 │
│ SHARD ◄── 同期 ─────┼──────────────►│ SHARD │
│ tasks ◄── 同期 ─────┼──────────────►│ tasks │
│ inbox ◄── リアルタイム┼──────────────►│ inbox │
└──────────────────────┘ └──────────────────────┘
```
**クラウド不要。サーバー不要。同じWi-Fiだけで動作。**
### 2. 🧠 膨張しない共有記憶
80行のファイルを読むだけでプロジェクト全体を理解。古いエントリは自動アーカイブ。新エージェントは30秒でオンボーディング。
### 3. 📨 エージェントが直接コマンド
ユーザーへの伝言は不要。AがBにコマンド送信→Bが自動実行→結果をAに返送。
### 4. 🔍 提出前の自動レビュー
コード品質・テストカバレッジ・ドキュメントを自動チェック。不合格は具体的なフィードバック付きで自動差戻し。
## 対応エージェント
| エージェント | 統合方法 | セットアップ時間 |
|:--|:--|:--|
| **Claude Code** | `.claude/CLAUDE.md` に追記 | 1分 |
| **Reasonix** | `.reasonix/system.md` にコピー or MCPプラグイン | 1分 |
| **WorkBuddy** | `.workbuddy/memory/MEMORY.md` に追記 | 1分 |
| **Cursor** | `.cursor/rules` に統合 | 1分 |
| **Codex** | `AGENTS.md` としてコピー | 1分 |
| **任意エージェント** | プロジェクトルートに `AGENT_PROTOCOL.md` | 1分 |
**ファイルだけ。** SDK不要、ランタイム依存なし、ベンダーロックインなし。
## 30秒で始められる
```bash
npm i -g collab-cli
# シングルPC
collab setup --devices 1 --project "マイプロジェクト"
# マルチデバイス
collab setup --devices 2 \
--device-1 "PC-A:codex-1@Codex" \
--device-2 "PC-B:codex-2@Codex"
```
## 詳細ドキュメント
📋 コアコンセプト（バッジ、タスク、inbox、記憶、ハンドシェイク）
### バッジ — ロールベース権限制御
| レベル | 名前 | 権限 |
|:--|:--|:--|
| L0 | オブザーバー | 読み取り専用 |
| L1 | エグゼキューター | 自タスク+inbox書き込み |
| L2 | コントリビューター | L1+メモリ書き込み+レビュー提出 |
| L3 | レビュアー | L2+タスク承認+SHARD書き込み |
| L4 | 総工 | 全権限+タスク割当+バッジ管理 |
### タスク — ライフサイクル管理
```
DRAFT → ASSIGNED → IN_PROGRESS → REVIEW → DONE
```
### ハンドシェイク — 自動オンボーディング
各エージェント起動時にSHARD+バッジ+inbox+タスクを自動読み取り。
📨 エージェントコマンド（エージェント間直接コマンド）
```bash
collab cmd send --from claude-01 --to workbuddy-01 \
--type command --instruction "factor_pipeline.pyを実行" --priority P1
collab cmd list --to workbuddy-01 --status pending
collab cmd exec --agent workbuddy-01
```
🌐 LANノード（クロスデバイス同期詳細）
| ファイル | 同期？ | 戦略 |
|:--|:--:|:--|
| `SHARD.md` | ✅ | ベース、新しい方が勝ち |
| `tasks/` | ✅ | ステータスマージ |
| `memory/` | ✅ | 完全同期 |
| `inbox/` | ❌ | デバイスごと独立 |
```bash
collab node start --agents codex-1
collab node pull --host 192.168.1.100
collab node status
```
📚 完全CLIリファレンス
```bash
collab setup / init / status / handshake
collab badge issue/show/list
collab task create/list/status/update
collab inbox check/send/read/done
collab cmd send/list/exec/status
collab review create/submit/self/status
collab memory compact/stats
collab conflict list/resolve
collab heartbeat [--once] [--interval N]
collab dashboard [--port N]
collab mcp
collab node start/pull/status
collab git init/sync/status
```
## 開発
```bash
git clone https://github.com/yinsang0910-star/collab-cli.git
cd collab-cli && npm install && npm test # 109テスト全パス
```
## ライセンス
MIT