Brackish : laissez deux instances de Claude Code négocier un contrat API via OpenAPI 3.1

Brackish est un outil CLI qui permet à deux sessions Claude Code de négocier un contrat API via un document OpenAPI 3.1 partagé. Le problème qu'il résout : lorsque l'un des Claude dispose du code source FastAPI et l'autre du code source React/TypeScript, chacun fait des hypothèses sur les limites qui divergent. Brackish propose un canal de proposition/acceptation/rejet pour révéler et résoudre ces désaccords avant que le code d'implémentation ne soit écrit.

Comment ça marche

La dynamique adversarial est intentionnelle. Par exemple :

• Le Claude frontend rédige un POST en attendant une réponse immédiate.
• Le Claude backend sait que cette opération prend plusieurs minutes, il rejette donc la forme et propose un 202 Accepted avec un identifiant de tâche plus un flux SSE pour la complétion.
• Ce désaccord apparaît comme un rejet explicite avec une justification — avant que l'une ou l'autre partie n'écrive du code.

Brackish se place au milieu comme arbitre. Il ne connaît pas la bonne API, mais il impose que ce sur quoi les deux Claude s'accordent soit valide OpenAPI 3.1. La sortie alimente directement des outils comme openapi-typescript et fastapi-codegen — ancrée dans un standard réel, pas dans du markdown que deux modèles acceptent.

Installation

npm install -g brackish-cli && brackish install

À qui cela s'adresse

Les développeurs utilisant Claude Code pour des projets non triviaux où un seul Claude travaillant des deux côtés ne suffit pas — en particulier lorsque les équipes backend et frontend (ou sessions) doivent se mettre d'accord sur un contrat API.