Metadata-Version: 2.4
Name: token-cut-cli
Version: 0.1.1
Summary: Verify Token-Cut API integration from the terminal (no repo clone required)
Project-URL: Homepage, https://www.token-cut.com
Project-URL: Documentation, https://www.token-cut.com
Author: Token-Cut
License: MIT
Keywords: claude,copilot,cursor,llm,optimization,token-cut
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Description-Content-Type: text/markdown

# token-cut-cli

Public **client** for [Token-Cut](https://www.token-cut.com). Your proprietary API stays private; customers only get this thin CLI + MCP shim.

## Business model

| What | Public? | Paid? |
|------|---------|-------|
| This PyPI package (`token-cut-cli`) | Yes | Free to install |
| `cc_live_…` API key | — | Yes (your Stripe plans) |
| Optimization + Graphify on **your** API | Private server | Metered per key |

The CLI cannot optimize without a valid key against **your** deployment.

## Install

```bash
pip install token-cut-cli
```

Not on PyPI yet? Maintainer runs `./scripts/publish-cli.sh` from the repo root.  
Until then:

```bash
cd cli && pip install .
```

## Verify integration (~1 min)

```bash
export TOKEN_CUT_API_KEY=cc_live_your_key
token-cut verify
```

Calls `https://www.token-cut.com` (override with `TOKEN_CUT_API_URL`).

## IDE setup (Cursor · Claude · Copilot)

```bash
export TOKEN_CUT_API_KEY=cc_live_your_key
token-cut mcp-config > ~/.cursor/mcp.json
# merge if file already exists — restart IDE
```

Uses `python -m token_cut_cli.mcp_server` from the installed package (no git clone).

## Commands

| Command | Purpose |
|---------|---------|
| `token-cut verify` | Test key + optimize + graph on a public sample repo |
| `token-cut optimize "…"` | One-off optimize JSON |
| `token-cut mcp-config` | Print MCP config for IDEs |
| `token-cut-mcp` | MCP stdio server (called by IDE) |

## Publish (maintainers)

See [../docs/PYPI_PUBLISH.md](../docs/PYPI_PUBLISH.md).
