Skip to main content

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

Project description

Cuti - AI Development Environment & Multi-Agent Orchestration

PyPI Version Python Versions License Downloads Downloads Total

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

PyPIDocumentationGitHub

📊 Download Trends

Downloads Downloads

🚀 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, the experimental Hermes Agent integration, and future providers alongside Claude with cuti providers ...
  • Provider-aware setup - cuti mounts provider auth/config/skills, persistent CLI runtimes, and workspace instruction files for enabled tools
  • Turnkey OpenClaw - Run the current OpenClaw gateway, channels, browser, plugins, and voice-call flows with qt-openclaw ... or qt-OpenClaw ...
  • 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
qt-openclaw onboard
qt-openclaw up
cuti container --rebuild
cuti providers update codex
cuti providers update openclaw
cuti providers update hermes

When selected, cuti handles the provider-specific container wiring for auth, config mounts, persistent CLI installation, and standard instruction files such as CLAUDE.md, AGENTS.md, .hermes.md, HERMES.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, and HEARTBEAT.md. OpenClaw installs under ~/.cuti/provider-runtimes/openclaw, keeps runtime state under ~/.openclaw, and runs openclaw doctor --non-interactive during install/update/bootstrap. Hermes is currently marked experimental in cuti, but its state persists under ~/.hermes, including Hermes profiles under ~/.hermes/profiles. ~/.openclaw is mounted when available so hermes claw migrate --dry-run can inspect OpenClaw data before migration, and cuti providers update hermes now follows Hermes' native hermes update path so bundled skills and profile state stay aligned with upstream behavior.

OpenClaw Qt Container

Use qt-openclaw or qt-OpenClaw for the current OpenClaw runtime.

qt-openclaw onboard
qt-openclaw up
qt-openclaw channels-login --channel whatsapp
qt-openclaw browser start
qt-openclaw plugins install @openclaw/voice-call
qt-openclaw voice-setup
qt-openclaw voicecall status
qt-openclaw dashboard --no-open

The command enables the OpenClaw provider automatically and runs inside the standard provider-aware Qt container, with ~/.openclaw, ~/.agents, and the persistent OpenClaw CLI runtime mounted for reuse. OpenClaw's source-backed command families are exposed directly (models, mcp, sandbox, memory, wiki, approvals, nodes, devices, hooks, webhooks, tasks, cron, security, secrets, and more). For plugin commands added by future OpenClaw releases, use qt-openclaw run <command> ...; it forwards raw arguments to the installed OpenClaw CLI without requiring a cuti release.

📚 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

🤝 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


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cuti-0.1.72.tar.gz (241.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cuti-0.1.72-py3-none-any.whl (270.4 kB view details)

Uploaded Python 3

File details

Details for the file cuti-0.1.72.tar.gz.

File metadata

  • Download URL: cuti-0.1.72.tar.gz
  • Upload date:
  • Size: 241.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.11

File hashes

Hashes for cuti-0.1.72.tar.gz
Algorithm Hash digest
SHA256 282c335903915eee06850b783f4124ff2ee25397c8f155c1cc3a88f328577679
MD5 57a82122e12284b60e8d51619e6fdfe3
BLAKE2b-256 7acb06b1983989863bfaca23c302ce92e74a6082337a5144c57e0f0a58d78ea0

See more details on using hashes here.

File details

Details for the file cuti-0.1.72-py3-none-any.whl.

File metadata

  • Download URL: cuti-0.1.72-py3-none-any.whl
  • Upload date:
  • Size: 270.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.11

File hashes

Hashes for cuti-0.1.72-py3-none-any.whl
Algorithm Hash digest
SHA256 d447711558f06de26a43f43635d46a0d9bfd0b7f360eba7c258af5a2152c0921
MD5 851ed6da58a4ef860872a9c9f4275911
BLAKE2b-256 42e3cd1bea531a38ab0709c76ecda10662f4bb2909b6312f3aadac3f8b3d492d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page