Metadata-Version: 2.4
Name: cuti
Version: 0.1.11
Summary: Production-ready Claude Code utilities with command queuing, prompt aliases, web interface, and monitoring.
Project-URL: Documentation, https://github.com/nociza/cuti/blob/main/README.md
Project-URL: Homepage, https://github.com/nociza/cuti
Project-URL: Issues, https://github.com/nociza/cuti/issues
Project-URL: Repository, https://github.com/nociza/cuti
Author: claude-code, nociza
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: ai,automation,claude,cli,orchestration,queue
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Requires-Dist: aiofiles>=23.0.0
Requires-Dist: claude-monitor>=3.1.0
Requires-Dist: fastapi>=0.104.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: python-multipart>=0.0.6
Requires-Dist: pyyaml>=6.0
Requires-Dist: requests>=2.32.4
Requires-Dist: rich>=13.0.0
Requires-Dist: typer[all]>=0.9.0
Requires-Dist: uvicorn[standard]>=0.24.0
Requires-Dist: websockets>=12.0
Provides-Extra: container
Requires-Dist: docker>=6.0.0; extra == 'container'
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: mypy>=1.6.0; extra == 'dev'
Requires-Dist: pre-commit>=3.5.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

## Cuti

The one stop solution for all your dev tasks for Claude Code and friends. Queue and route prompts, manage agents, monitor usage, and work through a simple CLI or a small web UI (mobile supported). Local-first; no telemetry.

### Install

```bash
# Install uv if needed (recommended)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install cuti
uv tool install cuti

# Verify
cuti --help
```

Requires Python 3.9+. Claude Code CLI is required. Google Gemini is optional and would suppliment the agent orchestration if you have a working google gemini cli.

### Quick start

```bash
# Start the web UI (http://127.0.0.1:8000)
cuti web

# Or use the CLI directly
cuti add "Explore this codebase and summarize key modules"
cuti start
cuti status
```

### What it does

- Multi-agent orchestration (Claude, Gemini) with simple routing
- Command queue with prompt aliases and history
- Hierarchical todo system with master goals and sub-tasks
- Automatic rate limit handling with smart retry after reset
- Web UI (FastAPI) for status, agents, and history
- Real-time usage monitoring via claude-monitor
- Per-project workspace under `.cuti/`

### Dev containers

Run your project in a containerized dev environment with cuti and all tools pre-configured:

```bash
# Start interactive container (works from any directory)
cuti container

# Run a specific command
cuti container "cuti web"
cuti container "python script.py"
```

Features:
- Cuti installed and ready (from PyPI via `uv tool install`)
- Claude CLI installed (note: auth limitations in containers)
- Custom prompt shows `cuti:~/path $`
- Works from any project directory
- Python 3.11, Node.js 20, development tools included

Requires Docker (or Colima on macOS). See `docs/devcontainer.md` for details and Claude authentication notes.

### License

MIT. See `LICENSE`.
