Brackish: Zwei Claude Code-Instanzen einen API-Vertrag über OpenAPI 3.1 aushandeln lassen

Brackish ist ein CLI-Tool, mit dem zwei Claude Code-Sitzungen einen API-Vertrag über ein gemeinsames OpenAPI 3.1-Dokument aushandeln können. Das Problem, das es löst: Wenn ein Claude den FastAPI-Quellcode und ein anderer den React/TypeScript-Quellcode hat, treffen beide Annahmen über die Schnittstelle, die auseinandergehen. Brackish bietet einen Vorschlag/Annahme/Ablehnung-Kanal, um diese Meinungsverschiedenheiten aufzudecken und zu lösen, bevor Implementierungscode geschrieben wird.

So funktioniert es

Die konfrontative Dynamik ist beabsichtigt. Zum Beispiel:

• Der Frontend-Claude entwirft einen POST, der eine sofortige Antwort erwartet.
• Der Backend-Claude weiß, dass dieser Vorgang mehrere Minuten dauert, lehnt daher die Form ab und schlägt einen 202 Accepted mit einer Job-ID und einem SSE-Stream für den Abschluss vor.
• Diese Meinungsverschiedenheit wird als explizite Ablehnung mit einer Begründung sichtbar – bevor eine Seite Code schreibt.

Brackish sitzt als Vermittler dazwischen. Es weiß nicht, was die richtige API ist, aber es stellt sicher, dass das, worauf sich die beiden Claudes einigen, gültiges OpenAPI 3.1 ist. Die Ausgabe fließt direkt in Tools wie openapi-typescript und fastapi-codegen – basierend auf einem echten Standard, nicht auf irgendeinem Markdown, auf das sich zwei Modelle zufällig einigen.

Installation

npm install -g brackish-cli && brackish install

Für wen es gedacht ist

Entwickler, die Claude Code für nicht-triviale Projekte verwenden, bei denen ein einzelner Claude, der auf beiden Seiten arbeitet, nicht ausreicht – insbesondere wenn Backend- und Frontend-Teams (oder Sitzungen) sich auf einen API-Vertrag einigen müssen.