Metadata-Version: 2.4
Name: manicure
Version: 0.2.2
Summary: Provider-neutral context control plane for coding agents
Project-URL: Homepage, https://github.com/srobinson/manicure
Project-URL: Repository, https://github.com/srobinson/manicure
Project-URL: Issues, https://github.com/srobinson/manicure/issues
Project-URL: Changelog, https://github.com/srobinson/manicure/releases
Author-email: Stuart Robinson <stuart@alphab.io>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: anthropic,claude,coding-agents,context,debugging,inspector,llm,mitmproxy,proxy
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: Proxy Servers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Debuggers
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: aiofiles>=24.0
Requires-Dist: fastapi[standard]>=0.115.0
Requires-Dist: httpx>=0.28
Requires-Dist: mitmproxy<13,>=12.2
Requires-Dist: pydantic-settings>=2.6
Requires-Dist: typer>=0.15
Description-Content-Type: text/markdown

# manicure

> **mani**fest + **cur**at**e**. Care for the cargo your coding agent carries.

A provider-neutral context control plane for coding agents. Sits as a reverse proxy in front of Claude, captures every `/v1/messages` exchange, normalises payloads into an internal representation, runs them through a deterministic curation pipeline, and optionally pauses for manual editing in a schema-aware editor.

No cert install. No system proxy settings. No sudo.

## Install

```bash
uv tool install manicure     # recommended
pipx install manicure        # alternative
```

Or via the bootstrap script (installs uv first if missing):

```bash
curl -fsSL https://github.com/srobinson/manicure/releases/latest/download/install.sh | bash
```

## Quick start

```bash
# Start the workbench (proxy + web UI)
manicure start

# In another terminal, point your coding agent at it
ANTHROPIC_BASE_URL=http://localhost:8787 claude
```

Open `http://localhost:8788` to see the live log, the rules UI, and the breakpoint editor.

## What it does

Every `/v1/messages` request your agent sends gets:

1. **Captured** — full request and response, logged to `~/.manicure/exchanges/`.
2. **Curated** — a deterministic pipeline applies your rules (strip tools, truncate system parts, rewrite descriptions, drop thinking blocks).
3. **Paused** (optional) — arm the breakpoint to edit the next request in a schema-aware editor before it forwards upstream.

All visible in a web UI at `http://localhost:8788`.

## Why

A single Claude Code session routinely sends 285 KB payloads: 147 tools, 3 system parts, 5 message turns. Tools alone account for 67% of that. Manicure gives you visibility into what's being sent, a pipeline to strip and rewrite it, and a breakpoint to intervene before it hits the API.

## Documentation

Full docs, architecture, and contributing guide: <https://github.com/srobinson/manicure>

## License

Apache 2.0. See [LICENSE](LICENSE).
