Supported setups
Tested combinations of hub locations, storage kinds, operating systems, and agent harnesses.
Hub location and storage
| Hub location | Storage kind | Fresh setup | Joined machine |
|---|---|---|---|
| AWS | S3 | Supported | Agent refresh supported; project add owner-only |
| AWS | Google Cloud Storage (GCS) | Not supported | Agent refresh supported; project add owner-only |
| AWS | Local folder | Not supported | Agent refresh supported; project add owner-only |
| Google Cloud | Google Cloud Storage (GCS) | Supported | Agent refresh supported; project add owner-only |
| Google Cloud | S3 | Not supported | Agent refresh supported; project add owner-only |
| Google Cloud | Local folder | Not supported | Agent refresh supported; project add owner-only |
| Local (this computer) | Local folder | Supported | Agent refresh supported; project add owner-only |
| Local (this computer) | S3 | Not supported | Agent refresh supported; project add owner-only |
| Local (this computer) | Google Cloud Storage (GCS) | Not supported | Agent refresh supported; project add owner-only |
On joined agent machines, agent refresh is supported for every hub and storage; project creation is owner-only.
Operating systems and harnesses
| Operating system | Harness | CLI command | Roles | Status |
|---|---|---|---|---|
| macOS, Linux, Windows | Kimi · Kimi Code CLI | kimi |
Worker, Coordinator | Supported |
| macOS, Linux, Windows | Grok · Grok Build CLI | grok |
Worker, Coordinator | Supported |
| macOS, Linux, Windows | Gemini · Antigravity CLI | agy |
Worker, Coordinator | Supported |
| macOS, Linux, Windows | Claude · Claude Code CLI | claude |
Worker, Coordinator | Supported |
| macOS, Linux, Windows | ChatGPT · Codex CLI | codex |
Worker, Coordinator | Supported |
| macOS, Linux, Windows | Cursor · Cursor CLI | cursor-agent |
Worker, Coordinator | Supported |
| macOS, Linux, Windows | Qwen · Qwen Code | qwen |
Worker, Coordinator | Supported |
| macOS, Linux, Windows | Qwen · Token Plan | qwen |
Worker, Coordinator | Supported |
| macOS, Linux, Windows | Mistral Vibe · Vibe CLI | vibe |
Worker, Coordinator | Supported |
| macOS, Linux, Windows | GitHub Copilot · Copilot CLI | copilot |
Worker, Coordinator | Supported |
| macOS, Linux, Windows | Local compute · Hermes Agent | hermes |
Worker | Supported |
| macOS, Linux, Windows | Generic harness | Custom CLI | Worker, Coordinator | Supported |
Troubleshooting
- Telegram bot: Ensure your bot has administrator permissions with Manage topics enabled in your Telegram group.
- Cloud account: Ensure your cloud CLI is logged in before running setup.
- AI harness: Open your provider CLI in your terminal and complete interactive sign-in before starting your agents.
- Local hub: If running on this computer, keep the hub terminal running while agents work.