Skip to main content

Provider-neutral context control plane for coding agents

Project description

manicure

manifest + curate. 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

uv tool install manicure     # recommended
pipx install manicure        # alternative

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

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

Quick start

# 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

manicure-0.2.3.tar.gz (173.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

manicure-0.2.3-py3-none-any.whl (156.1 kB view details)

Uploaded Python 3

File details

Details for the file manicure-0.2.3.tar.gz.

File metadata

  • Download URL: manicure-0.2.3.tar.gz
  • Upload date:
  • Size: 173.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for manicure-0.2.3.tar.gz
Algorithm Hash digest
SHA256 332c9c9c9a21103ebfbaa3721460416b87f9f111ae6f85542788eff4f258c12a
MD5 a8a2f3019994f8249d9dd01c43723a64
BLAKE2b-256 a684bb3aefb8d7a0f9b2ea91a6d1c6f5e6dc123f7785b3d8e06a4cf06b0f6264

See more details on using hashes here.

Provenance

The following attestation bundles were made for manicure-0.2.3.tar.gz:

Publisher: release.yml on srobinson/manicure

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file manicure-0.2.3-py3-none-any.whl.

File metadata

  • Download URL: manicure-0.2.3-py3-none-any.whl
  • Upload date:
  • Size: 156.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for manicure-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 7eac3154172306331f3f2fb28f9d1f8449f0f14a3d129ec7bac4107912957000
MD5 fb9f1cb5ff073a2eb29b8e9eeadf7bb3
BLAKE2b-256 c34ff3fd1e7f062b98d75b68e9d9b9c3dc873736236bead9b7c84074f3642a9d

See more details on using hashes here.

Provenance

The following attestation bundles were made for manicure-0.2.3-py3-none-any.whl:

Publisher: release.yml on srobinson/manicure

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page