Skip to content

nociza/cuti

Repository files navigation

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


About

Utillity Module for Claude Code. Dev Container, Clawdbot, queuing commands, prompt history, prompt alias, everything in one place

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors