Installation

Requirements

• Python >=3.11 (Linux, macOS, and Windows).
• GitHub CLI (gh) — Install and authenticate with gh auth login.
• Install only the CLIs used by configured profiles:
• OpenCode (opencode)
• Codex (codex)
• Claude Code (claude)

• Cursor CLI (agent)

• uv to install the application.

Install

Install the published package from PyPI. The source repository is caipora-labs/curupira.

uv tool install "curupira==0.1.0"

Confirm the command is available with curupira --version. The short alias curu --version runs the same program.

Create a configuration

OpsCli reads ~/.curupira/settings.toml by default. Download the example configuration:

mkdir -p ~/.curupira
curl -fsSL https://raw.githubusercontent.com/caipora-labs/curupira/main/curupira.example.toml \
  -o ~/.curupira/settings.toml

On Windows PowerShell:

New-Item -ItemType Directory -Force "$HOME\.curupira"
Invoke-WebRequest `
  -Uri https://raw.githubusercontent.com/caipora-labs/curupira/main/curupira.example.toml `
  -OutFile "$HOME\.curupira\settings.toml"

Edit repositories, queries, and prompts in the TOML. The ~/.curupira directory also stores state and logs. Pass --config path/to/settings.toml to use another file.