Cuti - AI Development Environment & Multi-Agent Orchestration

<div align="center">

Instant containerized development with Claude Code by default, plus provider-aware agent tooling

PyPI • Documentation • GitHub

</div>

📊 Download Trends

<div align="center">

</div>

🚀 Quick Start - Docker Container with Claude Code

# Install Python package from PyPI
uv tool install cuti

# Launch Docker development environment with Claude
cuti container

That's it! You now have a fully configured AI-powered coding environment with:

• ✅ Claude Code CLI pre-configured with Anthropic integration
• ✅ Persistent authentication for Claude API across sessions
• ✅ Python 3.11, Node.js 20, and essential dev tools
• ✅ Custom prompt showing cuti:~/path $
• ✅ Auto-mounts current directory for seamless workflow

The Docker container provides isolated, reproducible AI-assisted development with Claude as the default agent provider.

🌟 Key Features - AI Agent Orchestration & Automation

Build with multiple AI models and intelligent task management:

• Multi-agent orchestration - Claude API, Gemini integration
• Command queuing system with priority execution
• Read-only ops console - Launch with cuti web to inspect provider readiness, queue state, recent activity, and workspace drift
• Smart rate limiting - Automatic retry & backoff
• Task automation - Built-in todo system for AI agents
• Claude version switching - Easy CLI version management
• Agent providers - Enable Codex, OpenCode, OpenClaw, and future providers alongside Claude with cuti providers ...
• Provider-aware setup - cuti mounts provider auth/config/skills and updates common instruction files for enabled tools
• Legacy Clawdbot sandbox - Run the older gateway + messaging workflow separately with cuti clawdbot ...
• Claude chat history - cuti history shows transcripts and reopens old Claude Code sessions

Perfect for AI-powered development, automation workflows, and LLM orchestration.

🤖 Agent Providers

Claude is enabled by default. Additional providers are opt-in and can be enabled together:

cuti providers list
cuti providers doctor
cuti providers enable codex
cuti providers enable opencode
cuti providers enable openclaw
cuti providers auth claude --login
cuti container --rebuild
cuti providers update codex

When selected, cuti handles the provider-specific container wiring for auth, config mounts, CLI installation, and standard instruction files such as CLAUDE.md, AGENTS.md, SOUL.md, and TOOLS.md. The host CLI can also inspect readiness, launch setup flows, and refresh provider installs through cuti providers ....

📚 Documentation

📖 Documentation Guides

| Guide | Description | |-------|-------------| | Docker Container Setup | Container runtime, provider selection, mounts, and auth | | Claude Authentication | Anthropic API & Claude CLI setup | | Claude Account Switching | Manage multiple Claude accounts | | Claude API Keys | Anthropic & AWS Bedrock API key management | | Task Management | AI agent todo system | | Rate Limit Handling | Smart API throttling & retry logic | | Claude Chat History | Inspect & resume Claude Code sessions | | Clawdbot Sandbox | Legacy Clawdbot gateway workflow in the separate sandbox profile |

🤝 Contributing

Note: This project is under active development. Contributions welcome!

uv install -e .

Submit PRs to GitHub | Report issues in Issues

📄 License

Apache 2.0 - See LICENSE

---

<div align="center">

PyPI • Issues • Contribute

</div>

🦞 Clawdbot Sandbox

cuti clawdbot is a separate legacy sandbox workflow. It is not part of provider selection and uses its own hardened runtime profile plus persistent storage under ~/.cuti/clawdbot/.

• cuti clawdbot onboard – run the official wizard with OAuth + skill setup
• cuti clawdbot start – launch the gateway, auto-pick a port, stream logs
• cuti clawdbot config – edit clawdbot.json safely inside the container
• cuti clawdbot channels-login – scan WhatsApp QR or add other channels
• cuti clawdbot send --to +15551234567 --message "Hello" – quick smoke test

See docs/clawdbot.md for storage layout, channel details, and troubleshooting tips.