cuti

agent
Security Audit
Pass
Health Pass
  • License — License: NOASSERTION
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 21 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This utility acts as an all-in-one development environment and multi-agent orchestrator. It provides containerized workflows, manages multiple AI provider integrations (like Claude and Gemini), and offers command queuing alongside chat history tracking.

Security Assessment
Overall Risk: Medium. By design, this agent executes shell commands, specifically triggering Docker containers and managing CLI tools. It inherently makes external network requests to interact with AI provider APIs (such as Anthropic). While the automated code scan found no dangerous patterns or hardcoded secrets, managing multiple external provider authentications means it routinely handles sensitive API keys. No dangerous system permissions were requested, but users should be aware of its extensive system access.

Quality Assessment
The project appears to be actively maintained, with repository activity as recent as today. It has a small but present community footprint with 21 GitHub stars and clear documentation. However, the repository license is marked as NOASSERTION. While the PyPI badges suggest an MIT license, the lack of a clearly defined license file in the source repository is a notable oversight for an open-source tool.

Verdict
Use with caution: the codebase itself is clean and actively maintained, but its deep system integration and ambiguous licensing warrant a careful review of how your AI API keys are managed.
SUMMARY

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

README.md

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, 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


🦞 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.

Reviews (0)

No results found