Instant containerized development with Claude Code by default, plus provider-aware agent tooling
PyPI • Documentation • GitHub
# Install Python package from PyPI
uv tool install cuti
# Launch Docker development environment with Claude
cuti containerThat'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.
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 webto 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 historyshows transcripts and reopens old Claude Code sessions
Perfect for AI-powered development, automation workflows, and LLM orchestration.
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 codexWhen 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 ....
| 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 |
Note: This project is under active development. Contributions welcome!
uv install -e .Submit PRs to GitHub | Report issues in Issues
Apache 2.0 - See LICENSE
PyPI • Issues • Contribute
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 setupcuti clawdbot start– launch the gateway, auto-pick a port, stream logscuti clawdbot config– editclawdbot.jsonsafely inside the containercuti clawdbot channels-login– scan WhatsApp QR or add other channelscuti clawdbot send --to +15551234567 --message "Hello"– quick smoke test
See docs/clawdbot.md for storage layout, channel details, and troubleshooting tips.