interagent-framework 0.3.0__tar.gz → 0.4.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- interagent_framework-0.4.0/PKG-INFO +28 -0
- interagent_framework-0.4.0/README.md +12 -0
- interagent_framework-0.4.0/interagent_framework.egg-info/PKG-INFO +28 -0
- interagent_framework-0.4.0/interagent_framework.egg-info/SOURCES.txt +7 -0
- interagent_framework-0.4.0/interagent_framework.egg-info/requires.txt +1 -0
- interagent_framework-0.4.0/interagent_framework.egg-info/top_level.txt +1 -0
- interagent_framework-0.4.0/pyproject.toml +25 -0
- interagent_framework-0.3.0/LICENSE +0 -21
- interagent_framework-0.3.0/MANIFEST.in +0 -8
- interagent_framework-0.3.0/PKG-INFO +0 -370
- interagent_framework-0.3.0/README.md +0 -336
- interagent_framework-0.3.0/examples/README.md +0 -187
- interagent_framework-0.3.0/examples/basic_workflow.py +0 -267
- interagent_framework-0.3.0/examples/cli_session.bat +0 -75
- interagent_framework-0.3.0/examples/cli_session.sh +0 -101
- interagent_framework-0.3.0/examples/parallel_workflow.py +0 -151
- interagent_framework-0.3.0/pyproject.toml +0 -78
- interagent_framework-0.3.0/src/interagent/__init__.py +0 -23
- interagent_framework-0.3.0/src/interagent/cli.py +0 -1317
- interagent_framework-0.3.0/src/interagent/constants.py +0 -129
- interagent_framework-0.3.0/src/interagent/locking.py +0 -147
- interagent_framework-0.3.0/src/interagent/messaging.py +0 -185
- interagent_framework-0.3.0/src/interagent/session.py +0 -156
- interagent_framework-0.3.0/src/interagent/task.py +0 -204
- interagent_framework-0.3.0/src/interagent/templates/__init__.py +0 -35
- interagent_framework-0.3.0/src/interagent/templates/agents_guide.md +0 -172
- interagent_framework-0.3.0/src/interagent/templates/ai_context.md +0 -119
- interagent_framework-0.3.0/src/interagent/templates/review_request.md +0 -68
- interagent_framework-0.3.0/src/interagent/templates/roles_template.md +0 -59
- interagent_framework-0.3.0/src/interagent/templates/task_delegation.md +0 -69
- interagent_framework-0.3.0/src/interagent/templates/update_prompt.md +0 -70
- interagent_framework-0.3.0/src/interagent/transport/__init__.py +0 -32
- interagent_framework-0.3.0/src/interagent/transport/base.py +0 -37
- interagent_framework-0.3.0/src/interagent/transport/config.py +0 -47
- interagent_framework-0.3.0/src/interagent/transport/git.py +0 -368
- interagent_framework-0.3.0/src/interagent/transport/http.py +0 -72
- interagent_framework-0.3.0/src/interagent/transport/local.py +0 -71
- interagent_framework-0.3.0/src/interagent/utils.py +0 -90
- interagent_framework-0.3.0/src/interagent/validator.py +0 -171
- interagent_framework-0.3.0/src/interagent/watchdog.py +0 -197
- interagent_framework-0.3.0/src/interagent_framework.egg-info/PKG-INFO +0 -370
- interagent_framework-0.3.0/src/interagent_framework.egg-info/SOURCES.txt +0 -38
- interagent_framework-0.3.0/src/interagent_framework.egg-info/entry_points.txt +0 -4
- interagent_framework-0.3.0/src/interagent_framework.egg-info/requires.txt +0 -7
- interagent_framework-0.3.0/src/interagent_framework.egg-info/top_level.txt +0 -1
- {interagent_framework-0.3.0/src → interagent_framework-0.4.0}/interagent_framework.egg-info/dependency_links.txt +0 -0
- {interagent_framework-0.3.0 → interagent_framework-0.4.0}/setup.cfg +0 -0
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: interagent-framework
|
|
3
|
+
Version: 0.4.0
|
|
4
|
+
Summary: DEPRECATED — renamed to agentweave-ai. Install: pip install agentweave-ai
|
|
5
|
+
Author: gutohuida
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/gutohuida/AgentWeave
|
|
8
|
+
Keywords: deprecated,agentweave,agents,ai
|
|
9
|
+
Classifier: Development Status :: 7 - Inactive
|
|
10
|
+
Classifier: Intended Audience :: Developers
|
|
11
|
+
Classifier: Operating System :: OS Independent
|
|
12
|
+
Classifier: Programming Language :: Python :: 3
|
|
13
|
+
Requires-Python: >=3.8
|
|
14
|
+
Description-Content-Type: text/markdown
|
|
15
|
+
Requires-Dist: agentweave-ai>=0.4.0
|
|
16
|
+
|
|
17
|
+
# interagent-framework — DEPRECATED
|
|
18
|
+
|
|
19
|
+
This package has been renamed to **[agentweave-ai](https://pypi.org/project/agentweave-ai/)**.
|
|
20
|
+
|
|
21
|
+
Please update your installation:
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
pip uninstall interagent-framework
|
|
25
|
+
pip install agentweave-ai
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
This stub package installs `agentweave-ai` as a dependency to ease migration.
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# interagent-framework — DEPRECATED
|
|
2
|
+
|
|
3
|
+
This package has been renamed to **[agentweave-ai](https://pypi.org/project/agentweave-ai/)**.
|
|
4
|
+
|
|
5
|
+
Please update your installation:
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
pip uninstall interagent-framework
|
|
9
|
+
pip install agentweave-ai
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
This stub package installs `agentweave-ai` as a dependency to ease migration.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: interagent-framework
|
|
3
|
+
Version: 0.4.0
|
|
4
|
+
Summary: DEPRECATED — renamed to agentweave-ai. Install: pip install agentweave-ai
|
|
5
|
+
Author: gutohuida
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/gutohuida/AgentWeave
|
|
8
|
+
Keywords: deprecated,agentweave,agents,ai
|
|
9
|
+
Classifier: Development Status :: 7 - Inactive
|
|
10
|
+
Classifier: Intended Audience :: Developers
|
|
11
|
+
Classifier: Operating System :: OS Independent
|
|
12
|
+
Classifier: Programming Language :: Python :: 3
|
|
13
|
+
Requires-Python: >=3.8
|
|
14
|
+
Description-Content-Type: text/markdown
|
|
15
|
+
Requires-Dist: agentweave-ai>=0.4.0
|
|
16
|
+
|
|
17
|
+
# interagent-framework — DEPRECATED
|
|
18
|
+
|
|
19
|
+
This package has been renamed to **[agentweave-ai](https://pypi.org/project/agentweave-ai/)**.
|
|
20
|
+
|
|
21
|
+
Please update your installation:
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
pip uninstall interagent-framework
|
|
25
|
+
pip install agentweave-ai
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
This stub package installs `agentweave-ai` as a dependency to ease migration.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
agentweave-ai>=0.4.0
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=61.0", "wheel"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "interagent-framework"
|
|
7
|
+
version = "0.4.0"
|
|
8
|
+
description = "DEPRECATED — renamed to agentweave-ai. Install: pip install agentweave-ai"
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
license = "MIT"
|
|
11
|
+
authors = [
|
|
12
|
+
{name = "gutohuida"},
|
|
13
|
+
]
|
|
14
|
+
keywords = ["deprecated", "agentweave", "agents", "ai"]
|
|
15
|
+
classifiers = [
|
|
16
|
+
"Development Status :: 7 - Inactive",
|
|
17
|
+
"Intended Audience :: Developers",
|
|
18
|
+
"Operating System :: OS Independent",
|
|
19
|
+
"Programming Language :: Python :: 3",
|
|
20
|
+
]
|
|
21
|
+
requires-python = ">=3.8"
|
|
22
|
+
dependencies = ["agentweave-ai>=0.4.0"]
|
|
23
|
+
|
|
24
|
+
[project.urls]
|
|
25
|
+
Homepage = "https://github.com/gutohuida/AgentWeave"
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2024 InterAgent Team
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
@@ -1,370 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: interagent-framework
|
|
3
|
-
Version: 0.3.0
|
|
4
|
-
Summary: Multi-agent AI collaboration framework (Claude, Kimi, Gemini, Codex, and more)
|
|
5
|
-
Author: gutohuida
|
|
6
|
-
License-Expression: MIT
|
|
7
|
-
Project-URL: Homepage, https://github.com/gutohuida/InterAgentFramework
|
|
8
|
-
Project-URL: Documentation, https://github.com/gutohuida/InterAgentFramework#readme
|
|
9
|
-
Project-URL: Repository, https://github.com/gutohuida/InterAgentFramework
|
|
10
|
-
Project-URL: Issues, https://github.com/gutohuida/InterAgentFramework/issues
|
|
11
|
-
Project-URL: Changelog, https://github.com/gutohuida/InterAgentFramework/blob/master/CHANGELOG.md
|
|
12
|
-
Keywords: claude,kimi,gemini,codex,collaboration,agents,ai,code,multi-agent
|
|
13
|
-
Classifier: Development Status :: 4 - Beta
|
|
14
|
-
Classifier: Intended Audience :: Developers
|
|
15
|
-
Classifier: Operating System :: OS Independent
|
|
16
|
-
Classifier: Programming Language :: Python :: 3
|
|
17
|
-
Classifier: Programming Language :: Python :: 3.8
|
|
18
|
-
Classifier: Programming Language :: Python :: 3.9
|
|
19
|
-
Classifier: Programming Language :: Python :: 3.10
|
|
20
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
21
|
-
Classifier: Programming Language :: Python :: 3.12
|
|
22
|
-
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
23
|
-
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
24
|
-
Requires-Python: >=3.8
|
|
25
|
-
Description-Content-Type: text/markdown
|
|
26
|
-
License-File: LICENSE
|
|
27
|
-
Provides-Extra: dev
|
|
28
|
-
Requires-Dist: pytest>=7.0; extra == "dev"
|
|
29
|
-
Requires-Dist: pytest-cov>=4.0; extra == "dev"
|
|
30
|
-
Requires-Dist: black>=23.0; extra == "dev"
|
|
31
|
-
Requires-Dist: ruff>=0.1.0; extra == "dev"
|
|
32
|
-
Requires-Dist: mypy>=1.0; extra == "dev"
|
|
33
|
-
Dynamic: license-file
|
|
34
|
-
|
|
35
|
-
# InterAgent
|
|
36
|
-
|
|
37
|
-
[](https://www.python.org/)
|
|
38
|
-
[](https://opensource.org/licenses/MIT)
|
|
39
|
-
[](https://badge.fury.io/py/interagent-framework)
|
|
40
|
-
|
|
41
|
-
> **A collaboration framework for Claude Code and Kimi Code**
|
|
42
|
-
|
|
43
|
-
InterAgent lets Claude Code and Kimi Code work together on the same project — on the same machine or across machines. After a one-time setup, you orchestrate everything through **natural language prompts** — no manual CLI commands required during your session.
|
|
44
|
-
|
|
45
|
-
---
|
|
46
|
-
|
|
47
|
-
## How It Works
|
|
48
|
-
|
|
49
|
-
InterAgent creates a shared `.interagent/` directory that both agents use as a communication channel. The user acts as the messenger, passing relay prompts between agents.
|
|
50
|
-
|
|
51
|
-
```
|
|
52
|
-
You (setup once)
|
|
53
|
-
└─ interagent init --project "My App" --principal claude
|
|
54
|
-
|
|
55
|
-
You (natural language)
|
|
56
|
-
└─ "Claude, delegate the auth module to Kimi"
|
|
57
|
-
|
|
58
|
-
Claude (runs CLI via Bash automatically)
|
|
59
|
-
└─ interagent quick --to kimi "Implement auth module"
|
|
60
|
-
└─ interagent relay --agent kimi
|
|
61
|
-
└─ [shows you the relay prompt to paste into Kimi]
|
|
62
|
-
|
|
63
|
-
You
|
|
64
|
-
└─ paste relay prompt into Kimi Code
|
|
65
|
-
|
|
66
|
-
Kimi (reads AGENTS.md + context.md, runs CLI via terminal)
|
|
67
|
-
└─ interagent task update <id> --status in_progress
|
|
68
|
-
└─ [does the work]
|
|
69
|
-
└─ interagent task update <id> --status completed
|
|
70
|
-
└─ interagent msg send --to claude --subject "Done" --message "..."
|
|
71
|
-
|
|
72
|
-
You
|
|
73
|
-
└─ "Claude, Kimi is done"
|
|
74
|
-
|
|
75
|
-
Claude (runs CLI via Bash automatically)
|
|
76
|
-
└─ interagent inbox --agent claude
|
|
77
|
-
└─ interagent summary
|
|
78
|
-
└─ [reviews Kimi's work and continues]
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
**The only manual step is pasting the relay prompt into Kimi.** Both agents handle all CLI commands themselves — you just have a conversation.
|
|
82
|
-
|
|
83
|
-
---
|
|
84
|
-
|
|
85
|
-
## Quick Start
|
|
86
|
-
|
|
87
|
-
### 1. Install
|
|
88
|
-
|
|
89
|
-
```bash
|
|
90
|
-
pip install interagent-framework
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
### 2. Initialize (once per project)
|
|
94
|
-
|
|
95
|
-
```bash
|
|
96
|
-
cd your-project/
|
|
97
|
-
interagent init --project "My App" --principal claude
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
This creates:
|
|
101
|
-
- `.interagent/AGENTS.md` — full collaboration guide that both agents read on startup
|
|
102
|
-
- `.interagent/shared/context.md` — fill this with your project description
|
|
103
|
-
- `.interagent/session.json` — session state
|
|
104
|
-
|
|
105
|
-
### 3. Fill in project context
|
|
106
|
-
|
|
107
|
-
Edit `.interagent/shared/context.md` and paste in your project description, current state, and any constraints. Both agents read this at the start of every task.
|
|
108
|
-
|
|
109
|
-
### 4. Start working — just prompt Claude
|
|
110
|
-
|
|
111
|
-
From this point, use natural language. Claude handles the CLI:
|
|
112
|
-
|
|
113
|
-
> "Claude, read `.interagent/AGENTS.md` to understand how we're collaborating,
|
|
114
|
-
> then delegate the database schema design to Kimi."
|
|
115
|
-
|
|
116
|
-
Claude will run `interagent quick` and `interagent relay` via Bash, then show you a prompt to paste into Kimi Code.
|
|
117
|
-
|
|
118
|
-
---
|
|
119
|
-
|
|
120
|
-
## Cross-Machine Collaboration (v0.2.0+)
|
|
121
|
-
|
|
122
|
-
By default, InterAgent works on a single machine via the local `.interagent/` directory. If your collaborator is on a different machine, enable **Git transport** with one command:
|
|
123
|
-
|
|
124
|
-
```bash
|
|
125
|
-
interagent transport setup --type git
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
This creates an orphan branch (`interagent/collab`) on your git remote. Messages and tasks are synced through it using git plumbing — your working tree and current branch are never touched.
|
|
129
|
-
|
|
130
|
-
### How to set up cross-machine
|
|
131
|
-
|
|
132
|
-
```bash
|
|
133
|
-
# Both developers run this (same git remote required):
|
|
134
|
-
interagent transport setup --type git --remote origin
|
|
135
|
-
|
|
136
|
-
# Check status
|
|
137
|
-
interagent transport status
|
|
138
|
-
|
|
139
|
-
# Force-fetch latest messages
|
|
140
|
-
interagent transport pull
|
|
141
|
-
|
|
142
|
-
# Revert to local-only
|
|
143
|
-
interagent transport disable
|
|
144
|
-
```
|
|
145
|
-
|
|
146
|
-
All existing commands (`quick`, `inbox`, `relay`, `task`, etc.) work identically — transport is transparent.
|
|
147
|
-
|
|
148
|
-
### Start watching for incoming messages
|
|
149
|
-
|
|
150
|
-
```bash
|
|
151
|
-
interagent-watch
|
|
152
|
-
```
|
|
153
|
-
|
|
154
|
-
Automatically adapts to the active transport. For git transport, polls every 10 seconds instead of 5.
|
|
155
|
-
|
|
156
|
-
---
|
|
157
|
-
|
|
158
|
-
## Commands Reference
|
|
159
|
-
|
|
160
|
-
### Session
|
|
161
|
-
|
|
162
|
-
```bash
|
|
163
|
-
interagent init --project "Name" --principal claude # Initialize
|
|
164
|
-
interagent status # Full status
|
|
165
|
-
interagent summary # Quick overview
|
|
166
|
-
```
|
|
167
|
-
|
|
168
|
-
### Delegation
|
|
169
|
-
|
|
170
|
-
```bash
|
|
171
|
-
interagent quick --to kimi "Task description" # Create + assign task
|
|
172
|
-
interagent relay --agent kimi # Generate relay prompt
|
|
173
|
-
interagent relay --agent claude # Generate relay for Claude
|
|
174
|
-
```
|
|
175
|
-
|
|
176
|
-
### Tasks
|
|
177
|
-
|
|
178
|
-
```bash
|
|
179
|
-
interagent task list # List all tasks
|
|
180
|
-
interagent task show <task_id> # View task details
|
|
181
|
-
interagent task update <task_id> --status in_progress
|
|
182
|
-
interagent task update <task_id> --status completed
|
|
183
|
-
interagent task update <task_id> --status approved
|
|
184
|
-
interagent task update <task_id> --status needs_revision --note "Fix X"
|
|
185
|
-
```
|
|
186
|
-
|
|
187
|
-
### Messaging
|
|
188
|
-
|
|
189
|
-
```bash
|
|
190
|
-
interagent inbox --agent claude # Check Claude's inbox
|
|
191
|
-
interagent inbox --agent kimi # Check Kimi's inbox
|
|
192
|
-
interagent msg send --to claude --subject "Done" --message "Implemented X"
|
|
193
|
-
```
|
|
194
|
-
|
|
195
|
-
### Transport (cross-machine)
|
|
196
|
-
|
|
197
|
-
```bash
|
|
198
|
-
interagent transport setup --type git # Enable git transport
|
|
199
|
-
interagent transport status # Show active transport
|
|
200
|
-
interagent transport pull # Force immediate fetch
|
|
201
|
-
interagent transport disable # Revert to local
|
|
202
|
-
```
|
|
203
|
-
|
|
204
|
-
### Template Maintenance
|
|
205
|
-
|
|
206
|
-
```bash
|
|
207
|
-
interagent update-template --agent claude --template-path ~/projects/template.txt
|
|
208
|
-
interagent update-template --agent claude --focus "sub-agents"
|
|
209
|
-
```
|
|
210
|
-
|
|
211
|
-
---
|
|
212
|
-
|
|
213
|
-
## What Gets Created on Init
|
|
214
|
-
|
|
215
|
-
```
|
|
216
|
-
.interagent/
|
|
217
|
-
├── AGENTS.md # Collaboration guide — both agents read this
|
|
218
|
-
├── README.md # Quick command reference
|
|
219
|
-
├── session.json # Session config (id, mode, principal)
|
|
220
|
-
├── shared/
|
|
221
|
-
│ └── context.md # Project state — fill this with your project description
|
|
222
|
-
├── tasks/
|
|
223
|
-
│ ├── active/ # JSON files for each active task
|
|
224
|
-
│ └── completed/ # Archived completed tasks
|
|
225
|
-
├── messages/
|
|
226
|
-
│ ├── pending/ # Unread messages
|
|
227
|
-
│ └── archive/ # Message history
|
|
228
|
-
└── agents/ # Agent status files
|
|
229
|
-
```
|
|
230
|
-
|
|
231
|
-
`.interagent/AGENTS.md` is the key file. Both Claude and Kimi read it on every session start to understand their roles, available commands, and the collaboration protocol.
|
|
232
|
-
|
|
233
|
-
---
|
|
234
|
-
|
|
235
|
-
## Prompt-First Workflow
|
|
236
|
-
|
|
237
|
-
### Delegating to Kimi
|
|
238
|
-
|
|
239
|
-
Just tell Claude what to assign. No CLI needed.
|
|
240
|
-
|
|
241
|
-
**You → Claude:**
|
|
242
|
-
> "Delegate the user authentication module to Kimi. It should include login, logout,
|
|
243
|
-
> JWT tokens, and password reset. See PLAN.md for the API design."
|
|
244
|
-
|
|
245
|
-
**Claude does automatically:**
|
|
246
|
-
```bash
|
|
247
|
-
interagent quick --to kimi "Implement user authentication: login, logout, JWT tokens, password reset. See PLAN.md §3 for API design."
|
|
248
|
-
interagent relay --agent kimi
|
|
249
|
-
```
|
|
250
|
-
|
|
251
|
-
**Claude shows you:**
|
|
252
|
-
```
|
|
253
|
-
====================================================================
|
|
254
|
-
RELAY PROMPT FOR KIMI
|
|
255
|
-
====================================================================
|
|
256
|
-
Copy and paste this to the agent:
|
|
257
|
-
|
|
258
|
-
@kimi - You have work in the InterAgent collaboration system.
|
|
259
|
-
|
|
260
|
-
Your role: delegate
|
|
261
|
-
Collaboration guide: read .interagent/AGENTS.md for commands, workflow, and protocol.
|
|
262
|
-
Project context: read .interagent/shared/context.md before starting.
|
|
263
|
-
|
|
264
|
-
[TASK] You have 1 new task(s):
|
|
265
|
-
- Implement user authentication (task-a3f2c1)
|
|
266
|
-
...
|
|
267
|
-
====================================================================
|
|
268
|
-
```
|
|
269
|
-
|
|
270
|
-
**You:** paste that into Kimi Code.
|
|
271
|
-
|
|
272
|
-
---
|
|
273
|
-
|
|
274
|
-
### Getting Kimi's Work Back to Claude
|
|
275
|
-
|
|
276
|
-
When Kimi is done:
|
|
277
|
-
|
|
278
|
-
**You → Claude:**
|
|
279
|
-
> "Kimi is done."
|
|
280
|
-
|
|
281
|
-
**Claude does automatically:**
|
|
282
|
-
```bash
|
|
283
|
-
interagent inbox --agent claude
|
|
284
|
-
interagent summary
|
|
285
|
-
```
|
|
286
|
-
|
|
287
|
-
---
|
|
288
|
-
|
|
289
|
-
## Safety Features
|
|
290
|
-
|
|
291
|
-
**File locking** — prevents race conditions when both agents work simultaneously. Tasks and messages use file-based mutexes with a 5-minute automatic timeout.
|
|
292
|
-
|
|
293
|
-
**Schema validation** — all JSON state files are validated before saving. Agent names, task statuses, and required fields are enforced.
|
|
294
|
-
|
|
295
|
-
**Input sanitization** — string length limits and type coercion before any write.
|
|
296
|
-
|
|
297
|
-
**Conflict-free git sync** — GitTransport appends files with UUID-suffixed names; two machines can never produce the same filename. Push conflicts are retried automatically.
|
|
298
|
-
|
|
299
|
-
---
|
|
300
|
-
|
|
301
|
-
## Roles
|
|
302
|
-
|
|
303
|
-
| Role | Agent | Responsibilities |
|
|
304
|
-
|---|---|---|
|
|
305
|
-
| Principal | Claude | Architecture, planning, review, final decisions |
|
|
306
|
-
| Delegate | Kimi | Implementation, execution, reporting back |
|
|
307
|
-
|
|
308
|
-
In hierarchical mode (default), Claude assigns work and reviews results.
|
|
309
|
-
In peer mode, both agents can assign tasks to each other.
|
|
310
|
-
|
|
311
|
-
---
|
|
312
|
-
|
|
313
|
-
## Roadmap
|
|
314
|
-
|
|
315
|
-
| Phase | Status | Description |
|
|
316
|
-
|---|---|---|
|
|
317
|
-
| Local transport | Done | Single-machine via `.interagent/` filesystem |
|
|
318
|
-
| Git transport | Done (v0.2.0) | Cross-machine via orphan branch, zero infra |
|
|
319
|
-
| InterAgent Hub | Planned | MCP server for multi-team collaboration, web dashboard |
|
|
320
|
-
|
|
321
|
-
The Hub (Phase 3) will be an **MCP server** — Claude Code and Kimi Code connect to it as a native MCP tool provider, enabling real-time delivery without polling and a web dashboard for project oversight. See [ROADMAP.md](ROADMAP.md) for the full plan.
|
|
322
|
-
|
|
323
|
-
---
|
|
324
|
-
|
|
325
|
-
## Installation Options
|
|
326
|
-
|
|
327
|
-
```bash
|
|
328
|
-
# From PyPI
|
|
329
|
-
pip install interagent-framework
|
|
330
|
-
|
|
331
|
-
# From source
|
|
332
|
-
git clone https://github.com/gutohuida/InterAgentFramework.git
|
|
333
|
-
cd InterAgentFramework
|
|
334
|
-
pip install -e .
|
|
335
|
-
```
|
|
336
|
-
|
|
337
|
-
---
|
|
338
|
-
|
|
339
|
-
## FAQ
|
|
340
|
-
|
|
341
|
-
**Q: Do I need to run CLI commands during my session?**
|
|
342
|
-
No. After `interagent init`, just talk to Claude. It runs all `interagent` commands via Bash automatically. The only manual step is pasting the relay prompt into Kimi.
|
|
343
|
-
|
|
344
|
-
**Q: How does Kimi know how to use the system?**
|
|
345
|
-
`interagent init` writes `.interagent/AGENTS.md` — a complete guide covering commands, workflow, and protocol. The relay prompt tells Kimi to read it before starting work.
|
|
346
|
-
|
|
347
|
-
**Q: Should I commit `.interagent/` to Git?**
|
|
348
|
-
Partially. The `.gitignore` excludes runtime state (tasks, messages, session.json, transport.json) but keeps AGENTS.md and README.md. This gives you documentation without committing transient data.
|
|
349
|
-
|
|
350
|
-
**Q: Can I use this with just Claude (no Kimi)?**
|
|
351
|
-
Yes — just skip the relay step. The session, task, and summary commands are useful even for single-agent projects to track progress.
|
|
352
|
-
|
|
353
|
-
**Q: Do both developers need the same git remote for cross-machine sync?**
|
|
354
|
-
Yes. Git transport requires a shared remote (e.g. `origin`). One developer runs `interagent transport setup --type git` to create the orphan branch, then the other runs the same command to connect to it.
|
|
355
|
-
|
|
356
|
-
**Q: What if Kimi doesn't have terminal access?**
|
|
357
|
-
The relay prompt includes the task details inline, so Kimi can read and respond without running any commands. The collaboration is less structured but still works.
|
|
358
|
-
|
|
359
|
-
---
|
|
360
|
-
|
|
361
|
-
## Links
|
|
362
|
-
|
|
363
|
-
- **GitHub:** https://github.com/gutohuida/InterAgentFramework
|
|
364
|
-
- **PyPI:** https://pypi.org/project/interagent-framework/
|
|
365
|
-
- **Issues:** https://github.com/gutohuida/InterAgentFramework/issues
|
|
366
|
-
- **Roadmap:** [ROADMAP.md](ROADMAP.md)
|
|
367
|
-
|
|
368
|
-
---
|
|
369
|
-
|
|
370
|
-
MIT License
|