Metadata-Version: 2.4
Name: ssimplifi-cli
Version: 1.8.0
Summary: Command-line interface for Prism by Ssimplifi — the AI gateway that picks the model for you.
Author-email: Ssimplifi <support@ssimplifi.com>
License: Apache-2.0
Project-URL: Homepage, https://ssimplifi.com
Project-URL: Documentation, https://ssimplifi.com/docs/cli
Project-URL: Repository, https://github.com/ravirdp/prism
Project-URL: Issues, https://github.com/ravirdp/prism/issues
Project-URL: Changelog, https://ssimplifi.com/blog
Keywords: ai,llm,gateway,openai,anthropic,prism,ssimplifi
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.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: click>=8.1
Requires-Dist: httpx>=0.27
Requires-Dist: rich>=13.0

# ssimplifi-cli — `prism` command-line tool

Drive the Prism AI gateway from your terminal. Chat completions, model catalog, usage stats, cache settings, routing policy, budget caps, workspaces, audit — every action available in the web dashboard, also available as a `prism` command.

```bash
pip install ssimplifi-cli
prism configure   # one-time: paste your API key from ssimplifi.com/dashboard/keys
prism chat "What's the capital of Australia?"
prism models      # list the 23 models Prism routes across
prism usage --week
prism cache stats
```

## Tier requirements

| Command | Tier needed |
|---|---|
| `prism chat`, `prism models` | any tier (Free included) |
| `prism configure`, `prism whoami` | any tier |
| Everything else (`usage`, `cache`, `policy`, `budget`, `keys`, `orgs`, `projects`, `members`, `subscription`, `audit`, `feedback`, `provider-health`) | **Pro** ($19/mo) or **Team** ($49/mo) |

If you're on the Free or Paid (pay-as-you-go) tier and try a gated command, you'll get a clean tier-upgrade message with a link to ssimplifi.com/pricing — no half-success / half-error confusion.

## Authentication

Two patterns:

1. **API key** — paste once via `prism configure`. Stored at `~/.prism/config.json`. The key never appears in shell history or stdout.
2. **Environment override** — set `PRISM_API_KEY` in your shell to use a different key without rewriting the config (useful for CI scripts).

## Installation

```bash
# PyPI (recommended)
pip install ssimplifi-cli

# Homebrew tap (macOS / Linux)
brew install ssimplifi/tap/prism
```

## Documentation

Full command reference: https://ssimplifi.com/docs/cli
Issue tracker: https://github.com/ravirdp/prism/issues

## License

Apache-2.0
