Metadata-Version: 2.4
Name: collab-hub
Version: 0.2.0
Summary: Unified MCP server for cross-platform multi-model AI collaboration
Project-URL: Homepage, https://github.com/pure-maple/multi-model-collab
Project-URL: Repository, https://github.com/pure-maple/multi-model-collab
Project-URL: Issues, https://github.com/pure-maple/multi-model-collab/issues
Project-URL: Documentation, https://github.com/pure-maple/multi-model-collab#readme
Author: pure-maple
License-Expression: MIT
License-File: LICENSE
Keywords: ai,claude,cli,codex,collaboration,gemini,mcp,multi-model
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: mcp[cli]>=1.20.0
Requires-Dist: pydantic>=2.0
Description-Content-Type: text/markdown

# collab-hub

Unified MCP server for cross-platform multi-model AI collaboration.

Route tasks to **Codex CLI**, **Gemini CLI**, and **Claude Code CLI** through a single MCP interface with smart routing and caller auto-detection.

## Install

```bash
# One-command install for Claude Code
claude mcp add collab-hub -s user -- uvx collab-hub

# Codex CLI (~/.codex/config.toml)
# [mcp_servers.collab-hub]
# command = "uvx"
# args = ["collab-hub"]

# Gemini CLI (~/.gemini/settings.json)
# {"mcpServers": {"collab-hub": {"command": "uvx", "args": ["collab-hub"]}}}
```

## Tools

- **`collab_dispatch`** — Send a task to a model and get structured results
  - `provider`: `"auto"` / `"codex"` / `"gemini"` / `"claude"`
  - `task`: The prompt to send
  - `workdir`, `sandbox`, `session_id`, `timeout`, `model`, `profile`, `reasoning_effort`
- **`collab_check`** — Check which CLIs are available, show detected caller and config

## Smart Routing

`provider="auto"` routes tasks by keyword analysis and auto-excludes the calling platform:

```
From Claude Code → routes to Codex or Gemini (never back to Claude)
From Codex CLI → routes to Claude or Gemini (never back to Codex)
```

## User Configuration

Create `.collab-hub/profiles.toml` or `~/.config/collab-hub/profiles.toml`:

```toml
[routing]
default_provider = "codex"

[[routing.rules]]
provider = "gemini"
[routing.rules.match]
keywords = ["frontend", "react", "css"]

[profiles.budget]
[profiles.budget.providers.codex]
model = "gpt-4.1-mini"
```

## Links

- [Full Documentation](https://github.com/pure-maple/multi-model-collab)
- [中文文档](https://github.com/pure-maple/multi-model-collab/blob/main/docs/README_CN.md)

## License

MIT
