ai-comm 0.2.4__py3-none-any.whl

ai_comm-0.2.4.dist-info/METADATA

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: ai-comm
+Version: 0.2.4
+Summary: Cross-AI CLI communication tool for kitty terminal
+Project-URL: Homepage, https://github.com/a322655/ai-comm
+Project-URL: Repository, https://github.com/a322655/ai-comm
+Author: WindFade
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,cli,communication,kitty,terminal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.13
+Requires-Dist: typer>=0.15.0
+Description-Content-Type: text/markdown
+
+# ai-comm
+
+Cross-AI CLI communication tool for [Kitty terminal](https://sw.kovidgoyal.net/kitty/). Enables AI assistants running in separate Kitty windows to communicate with each other.
+
+## Why ai-comm?
+
+When working with multiple AI coding assistants, you may want them to collaborate—code review across models, second opinions on architecture, or delegating specialized tasks.
+
+**Why terminal text instead of MCP or black magic?**
+
+- **Stability**: AI CLI tools evolve rapidly, with many still at 0.x and frequently introducing breaking changes. Terminal UI, being user-facing, remains far more stable.
+- **Lightweight**: MCP tools consume significant context (often tens of thousands of tokens at startup) and can cause attention dilution. ai-comm uses simple shell commands with minimal overhead.
+- **No infrastructure**: Each AI CLI maintains its own context. No need for external services like Redis to synchronize state across tools.
+- **Composability**: Shell pipelines and REPL patterns combine naturally, leveraging what CLIs already do well.
+
+## Setup
+
+### 1. Install ai-comm
+
+```bash
+# From PyPI
+uv tool install ai-comm
+
+# Or from GitHub
+uv tool install git+https://github.com/a322655/ai-comm.git
+```
+
+### 2. Configure Kitty
+
+Enable remote control in `~/.config/kitty/kitty.conf`:
+
+```conf
+allow_remote_control socket-only
+listen_on unix:/tmp/kitty-${USER}
+```
+
+### 3. Configure Your AI
+
+Add instructions to your AI’s project file (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, etc.) or skills system. An example Claude Code skill is provided in [`skills/ai-comm/`](skills/ai-comm/).
+
+## Usage
+
+1. **Open multiple AI CLIs** in separate Kitty windows:
+
+   ```bash
+   claude    # Window 1
+   codex     # Window 2
+   gemini    # Window 3
+   ```
+
+2. **Ask your AI to collaborate**:
+
+   > “Use ai-comm to ask Codex to review src/main.py”
+
+   The AI discovers available windows and sends the request:
+
+   ```bash
+   ai-comm list-ai-windows
+   #   ID  CLI         CWD
+   #   11  codex       /home/user/project
+   #   21  gemini      /home/user/project
+
+   ai-comm send "Review src/main.py for bugs" -w 11
+   # Returns Codex's response
+   ```
+
+3. **For long responses**, instruct the target AI to write to a file:
+
+   ```bash
+   ai-comm send "Write analysis to report_$(date +%Y%m%d_%H%M%S).md" -w 11
+   ```
+
+## Supported CLIs
+
+| CLI | Notes |
+|-----|-------|
+| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | — |
+| [Codex CLI](https://github.com/openai/codex) | — |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | — |
+| [Aider](https://aider.chat/) | Auto-prefixes `/ask` |
+| [Cursor Agent](https://cursor.sh/) | — |
+| [OpenCode](https://github.com/opencode-ai/opencode) | Uses export for responses |
+
+## Troubleshooting
+
+**“Window not found”**: Ensure the AI CLI is running in Kitty and remote control is enabled. Run `ai-comm list-ai-windows` to verify.
+
+**Empty responses**: For long outputs, ask the AI to write to a file instead of returning directly.
+
+**“Kitty I/O timeout”**: Check if Kitty is responsive; try restarting it.
+
+## Development
+
+```bash
+git clone https://github.com/a322655/ai-comm.git
+cd ai-comm
+uv sync
+
+uv run ai-comm --help
+uv run ruff check src/
+uv run mypy src/
+```
+
+### Adding a New CLI
+
+1. Add entry in `src/ai_comm/registry.py`
+2. Create adapter in `src/ai_comm/adapters/<name>.py` (class `{Name}Adapter`)
+3. Add detection in `src/ai_comm/kitten/ai_comm_kitten.py`
+
+## License
+
+MIT

ai_comm-0.2.4.dist-info/RECORD

@@ -0,0 +1,29 @@
+ai_comm/__init__.py,sha256=K0EjJFSp3zTu3OynEBoI0tokrRwmDT6rWucgUcoGxc0,81
+ai_comm/cli.py,sha256=AJPZtRHHdlaZj-ueeeY8WZaG4F5rm0hUZNmc8HVZKjI,2673
+ai_comm/kitten_client.py,sha256=DrDIK80zejjAIwXtF1Gh_4aSZikwPEmc3WLjSigScTw,5866
+ai_comm/polling.py,sha256=FpsJN1D_Tzp8HAeQkq__z14mdg6P3K4FDYROczYoYbU,2272
+ai_comm/registry.py,sha256=OIuh6FRUfRNpE9J_Z0A9BZNnr4F7Qf_2aROz5uko3Ug,1972
+ai_comm/adapters/__init__.py,sha256=9kOZZzwuwJY22cwJHKRNGN_l4Dc7Lk4LltgqqbrLVaI,933
+ai_comm/adapters/aider.py,sha256=b68UMXtmaZFoIzhKMNQzo3YkcMfPLF3N2cCLOltZNgM,1796
+ai_comm/adapters/base.py,sha256=kyuIisauBjKCUYkH84Ih0Q75NQJkTdr34rtZ3D5WQeU,4195
+ai_comm/adapters/claude.py,sha256=KjRG5YxNNt6S8KRtbG5GP4TUN7vjtRRHwVI5j5YjBRQ,2242
+ai_comm/adapters/codex.py,sha256=qqUJ_ubZtZtkbieFN0ehQc3fFDTFTFOyoNJ_24A84gs,1541
+ai_comm/adapters/cursor.py,sha256=vJzv-FqvRu91E4FL7TUqHYzi6HqcBR5aXLDVBFZ8iM4,1987
+ai_comm/adapters/gemini.py,sha256=JCFVXFK3Bad7n1otMUCFru3t_-ysIYkdQcHQDfwSYsk,1568
+ai_comm/adapters/generic.py,sha256=B_3JW2K-ADna-xKJ6W7iuav9WVCR_7TWh6vNZhABM1g,1507
+ai_comm/adapters/opencode.py,sha256=rp4pNlzQD650ux0EYpUSNPu75Dgb-1kCrhryllyoyDs,4532
+ai_comm/commands/__init__.py,sha256=AJB7gJ6-ML91qe4JSSHUZcjAhrvDbrzRXPf46SfieIE,285
+ai_comm/commands/response.py,sha256=pirqMij2KtL1sJzbZYlaYtkl34lB2Bolrgz4YNT_N38,3219
+ai_comm/commands/send.py,sha256=GEXE22lpkxyA8VLHK6eabXJScqK2dm6ZEEkxOFVsDQI,3427
+ai_comm/commands/window.py,sha256=QBXXI5BnojMxbAB311WyUqFu8LlOVmdL62cCC9Eafig,1077
+ai_comm/kitten/ai_comm_kitten.py,sha256=gO6EbshmH3ABqOlMoa_7afPPdWTu1Uhk-GShY38FnVI,8268
+ai_comm/parsers/__init__.py,sha256=Bzm6rOgBax_sbEf4teXXbM0q0WHvGldNU3hSzIHmdA8,579
+ai_comm/parsers/base.py,sha256=geuSRJxMKVCJDMKlKUlyB_KdZDoZuZYS5NwbWL_yDKc,3518
+ai_comm/parsers/utils.py,sha256=46UzBHWzmRaUCQvfAfwC0ef2WctHy7qHplFcDaucrzs,1238
+ai_comm/services/__init__.py,sha256=1BI4r1c56ByPl-juqBYfA8OjTh_stZ-mPpw23YRaXys,143
+ai_comm/services/interaction.py,sha256=l8BNJNM5l16TZ6xDAUgbqOQpoCHLWmf-Su9ToM39Du4,3554
+ai_comm-0.2.4.dist-info/METADATA,sha256=j6yjB3ezg1jz-_sqMkDKA1IRT5RyzLaD5kS4HCT26Uw,4151
+ai_comm-0.2.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+ai_comm-0.2.4.dist-info/entry_points.txt,sha256=C1o6yRE4qzTgSS6A3c1bMZg76-JdJXKBAGu7Y-WZP3E,45
+ai_comm-0.2.4.dist-info/licenses/LICENSE,sha256=Ii8GHNFlMpbN8cYuvjeDr3NLegvkINaGuJ7jqz9VjKs,1065
+ai_comm-0.2.4.dist-info/RECORD,,

ai_comm-0.2.4.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

ai_comm-0.2.4.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ai-comm = ai_comm.cli:main

ai_comm-0.2.4.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 WindFade
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.