Brackish: Let Two Claude Code Instances Negotiate an API Contract via OpenAPI 3.1
Brackish is a CLI tool that lets two Claude Code sessions negotiate an API contract over a shared OpenAPI 3.1 document. The problem it solves: when one Claude has the FastAPI source and another has the React/TypeScript source, each makes assumptions about the boundary that diverge. Brackish provides a propose/accept/reject channel to surface and resolve those disagreements before any implementation code gets written.
How it works
The adversarial dynamic is intentional. For example:
- The frontend Claude drafts a
POSTexpecting an immediate response. - The backend Claude knows that operation takes several minutes, so it rejects the shape and proposes a
202 Acceptedwith a job ID plus an SSE stream for completion. - That disagreement surfaces as an explicit rejection with a rationale — before either side writes code.
Brackish sits in the middle as an arbiter. It doesn't know what the right API is, but it enforces that whatever the two Claudes agree on is valid OpenAPI 3.1. The output feeds directly into tools like openapi-typescript and fastapi-codegen — grounded in a real standard, not whatever markdown two models happen to agree on.
Installation
npm install -g brackish-cli && brackish installWho it's for
Developers using Claude Code for non-trivial projects where one Claude working on both sides isn't sufficient — especially when backend and frontend teams (or sessions) need to agree on an API contract.
📖 Read the full source: r/ClaudeAI
👀 See Also
graphify-ts: Local MCP server cuts Claude Code PR review tokens from 63K to 8.7K
graphify-ts builds a local knowledge graph of your codebase using tree-sitter AST + Louvain communities + BM25 + optional ONNX rerank, exposing it via MCP stdio. In production tests, it reduced input tokens by 2.6x and latency by 2.8x for code queries, and cut PR review prompts from 63K to 8.7K tokens.
Replacing complex retrieval pipelines with simple git commands for AI agents
A developer replaced their 3GB Docker image with sentence-transformers, rank-bm25, and scikit-learn with a single tool that lets AI agents execute read-only shell commands like git log, grep, and git diff directly on their memory repository.
Prism MCP v5.1 adds 10x memory compression and agent learning from corrections
Prism MCP v5.1 introduces 10x memory compression via TurboQuant ported to TypeScript, enabling millions of memories on a laptop without vector databases. The update adds agent learning from user corrections and a visual knowledge graph interface.
Relay CLI tool saves Claude session context when rate limited
Relay is a Rust CLI tool that reads Claude's .jsonl session transcripts from disk and creates full snapshots of your session, including conversation, tool calls, todos, git state, and errors. It generates context prompts to resume sessions after rate limits reset.