cuti 0.1.71

Production-ready Claude Code utilities with command queuing, prompt aliases, web interface, and monitoring.

Cuti - AI Development Environment & Multi-Agent Orchestration

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

PyPI • Documentation • GitHub

📊 Download Trends

🚀 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, Hermes Agent, 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 enable hermes
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, .hermes.md, HERMES.md, SOUL.md, and TOOLS.md. Hermes Agent state persists under ~/.hermes, and ~/.openclaw is mounted when available so hermes claw migrate --dry-run can inspect OpenClaw data before migration. 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

---

PyPI • Issues • Contribute

🦞 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 [phone] --message "Hello" – quick smoke test

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