Metadata-Version: 2.4
Name: rgba
Version: 0.3.0
Summary: Command-line interface for RGBA — talk to api.rgba.ai from your terminal or Claude Code.
Author: RGBA
License-Expression: MIT
Project-URL: Homepage, https://rgba.ai
Project-URL: Documentation, https://rgba.ai/docs
Project-URL: Issues, https://rgba.ai/support
Keywords: rgba,ai,video,cli,claude,agent
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer<1.0,>=0.12
Requires-Dist: httpx<1.0,>=0.27
Dynamic: license-file

# rgba CLI

Thin HTTPS client for the deployed RGBA API (Modal-hosted). The CLI defaults
to the right backend URL; override with `RGBA_API_URL` for local dev.

## Install

```bash
pip install rgba             # from PyPI
pipx install rgba            # isolated user install (recommended for daily use)
```

After install you'll have a `rgba` command on your PATH.

## Usage

```bash
rgba auth login              # device-flow → opens https://rgba.ai/cli in your browser
rgba auth status             # show whoami
rgba auth logout             # revoke the active token

rgba me                      # alias for `auth status`
rgba actions                 # discover every /sdk/action with cost + params
rgba actions <name>          # full schema for one action
rgba sdk <action> -p key=val # call /sdk/action
rgba jobs get <job_id>       # poll a job
rgba jobs wait <job_id>      # poll until status is completed/failed
```

Credentials live in `~/.rgba/credentials` (mode 0600). The CLI never sees
your Supabase password — auth is brokered through a device-flow OAuth
against the RGBA backend.

## Environment

| var              | default                                                                  | use                                       |
|------------------|--------------------------------------------------------------------------|-------------------------------------------|
| `RGBA_API_URL`   | `https://lemontree-media-llc--rgba-agent-agent-app.modal.run`            | Override the API origin (e.g. localhost)  |
| `RGBA_CONFIG_DIR`| `~/.rgba`                                                                | Override credentials directory            |
