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.1.0.tar.gz (136.1 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.1.0-py3-none-any.whl (130.1 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for manicure-0.1.0.tar.gz
Algorithm Hash digest
SHA256 2d134f1757a6afe86b472638b839ea7aafaf42bc5d8dc3f60e08c6f2eab7ed56
MD5 03bef22371c04f9ee047e315c7e9ac32
BLAKE2b-256 b17f08dd6ee9f56ca9bba262e738921dc3c6f4bc6bf2df905f38b301cbbd4e1e

See more details on using hashes here.

Provenance

The following attestation bundles were made for manicure-0.1.0.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.1.0-py3-none-any.whl.

File metadata

  • Download URL: manicure-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 130.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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 798335356e559bcecef1c843732f2174e6a86bda11654116ee1fde952658410e
MD5 29bf3bb2e0008062364d092f6ff8c87e
BLAKE2b-256 552d858735791d12ab9a3e0372ffb3b4eb929b31cac17fffaa58ee293970247b

See more details on using hashes here.

Provenance

The following attestation bundles were made for manicure-0.1.0-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