Keelokit

Open source · dos plugins para Claude Code

Muchas sesiones que no se ven entre sí. Un puerto que las lleva a main.

Keelokit hace que una sesión de Claude Code trabaje como un equipo ordenado. Keelokit Harbor es el meta-orquestador de releases, la parte potente para cuando orquestar se complica: sesiones de Claude Desktop, de la CLI y de la nube, en varias cuentas, que no se ven entre sí. Cada una termina su trabajo; Harbor lo junta en main como releases coordinados y verificados, en orden.

Los dos salen de cientos de horas, a esta altura miles, desarrollando muchos proyectos en paralelo, con muchas sesiones en varias cuentas que tenían que seguir entregando software con casi nada de intervención, de día y de noche o sin supervisión.

un convoy rumbo a main

Qué hace cada uno

Dos plugins, dos trabajos.

Keelokit cuida el trabajo dentro de cada sesión. Harbor cuida el trabajo entre sesiones. No se pisan.

Keelokit

v0.13.0 · publicado

El método de cada sesión.Empezá acá

  • De la idea al monorepo: entrevista, PRD corto, stack, esqueleto con CI, backlog.
  • Un equipo, no un agente: un verificador escribe los tests, un constructor los hace pasar, un revisor lee en frío, un breaker ataca.
  • Cada regla tiene un check, y un doctor avisa cuando se pierde uno.
  • Sube una historia a main después de un verify local, y se detiene donde hace falta una persona.

Keelokit Harbor

v0.1.0 · publicado

El meta-orquestador de releases.

  • Convoys: muchas ramas se mergean en una, se verifican una vez y se suben una vez.
  • Un logbook en una rama de git que cada sesión, cuenta y máquina lee con git fetch.
  • Seals: una rama entra a un convoy solo con un resultado de verify para su commit exacto.
  • Un harbormaster a la vez, y un tope de sesiones por cuenta.

Harbor se apoya en Keelokit. Corre el verify de Keelokit, lee su estado y usa sus niveles. Keelokit decide qué tiene que probar una historia; Harbor decide cuándo llegan a main las historias ya probadas. Sin Keelokit en el proyecto, Harbor no hace nada.

Tres formas de llegar a main

Velero, buque de carga, convoy.

Solo Keelokit

El velero: una historia chica

Una sesión construye una historia, Keelokit la verifica en local y sube sola a main. Un verify por subida. Es lo normal en Keelokit.

build-story · nivel trivial o light · landing policy = direct

Solo Keelokit · controles más pesados

El buque de carga: una rama grande

Muchos archivos, o un área crítica como plata o permisos. El mismo camino con el proceso completo: más agentes, el verify entero. Solo, también atraca por su cuenta. Harbor no mide el tamaño; registra el nivel.

build-story · nivel full o un área crítica

Keelokit + Harbor

El convoy: varios vessels, una llegada

Cada sesión termina en su rama con un seal. Navegan juntos, se verifican una vez como conjunto y llegan a main en un solo push. En el mismo convoy van vessels chicos y grandes.

convoy/<n> · un verify · un push

Cuál instalar

Empezá con Keelokit. Sumá Harbor cuando esto empiece a doler.

Lo que decide es qué tan compleja es tu orquestación, no qué tan grande es el proyecto ni cuántas sesiones corrés. La señal para Harbor es tener sesiones de Claude Desktop, de la CLI y de la nube, en varias cuentas, que no se ven entre sí y hay que coordinar, o un equipo entero desarrollando en el mismo repo, con trabajo que tiene que llegar a `main` como releases que aterrizan juntos y en orden.

Sesiones que no dependen del trabajo de las otras, en una cuenta y una máquina.

Solo Keelokitsubida directa

Primera vez con agentes, o armando un primer MVP.

Solo Keelokitsubida directa

Varias CLI de desarrollo y sesiones para coordinar, locales y en la nube, que no se ven entre sí.

Sumá Harborun logbook, un convoy

Trabajo que tiene que llegar a main como releases: juntos, verificados una vez y en orden.

Sumá Harborconvoys y el ok del harbormaster

Un equipo entero desarrollando en el mismo repo.

Sumá Harborun logbook que lee todo el equipo

Más de una cuenta de Claude, o más de una máquina, la nube incluida.

Sumá Harborlogbook compartido

Cada subida cuesta un verify completo, y cada push a main dispara una corrida de CI que pagás.

Sumá Harborun verify y un push por convoy

Varias ramas tocan siempre lo mismo: schema, migraciones, tipos compartidos, textos.

Sumá Harborhotspots, de a uno

Solo, un MVP

Una notebook, una historia por vez, un plan de Claude. Keelokit sube cada historia cuando está probada. Nada que coordinar.

Un par de historias por día, algún ayudante

Un equipo chico donde a veces corren dos sesiones en paralelo. Alcanza con la skill coordinate de Keelokit: las sesiones no se pisan.

Desktop, CLI y nube, en dos cuentas

Dos cuentas de Claude, Claude Desktop en una notebook, la CLI y un contenedor en la nube. Ninguna sesión ve a las otras. Cada una termina en su rama; nadie ve la combinación hasta que se ensambla un convoy y se verifica una vez.

Una carpeta de migraciones que toca todo el mundo

Varias ramas agregan migraciones en la misma semana y los minutos de CI corren. Harbor las mantiene fuera del mismo convoy abierto y sube una sola vez.

Harbor se apoya en Keelokit, así que empezás por ahí y sumás Harbor cuando orquestar los releases se complica.

Cómo trabajan juntos

Keelokit prueba cada vessel. Harbor decide cuándo zarpa el convoy.

Las sesiones no se ven entre sí, así que Harbor les da algo que todas leen: un logbook en una rama de git. Cada sesión lo trae al arrancar, en cada prompt y antes de un push a main, para que ninguna decida con un estado viejo.

Cada sesión termina en su propia rama con el verify de Keelokit y un seal. Harbor las reúne en un convoy, un skipper lo ensambla, el harbormaster, uno a la vez y en su guardia, da el ok, y el convoy se verifica una vez y llega a main en un solo push. Escribir el logbook nunca mueve main ni dispara su CI.

el puerto es main

harbormaster

El capitán de puerto

Una sesión lleva la guardia: da el ok para zarpar y renueva un heartbeat. Si vence, cualquier sesión puede tomarla; gana el primer commit.

skipper

El patrón del convoy

La sesión que lleva un convoy: mergea main y los vessels en convoy/<n> y arregla la combinación.

vessel

Una embarcación

La rama de una sesión, hecha con build-story. Grande o chica, entra con su commit exacto.

logbook

El cuaderno de bitácora

La rama harbor/log: archivos TOML que solo escribe Harbor, y páginas generadas a partir de ellos. Todos lo leen con git fetch.

seal

El precinto

Un resultado de verify de un commit exacto. Si sumás un commit, el seal ya no vale: la entrega queda anulada hasta verificar de nuevo.

hotspot

El canal angosto

Rutas que declarás compartidas (schema, migraciones, textos). Dos ramas que tocan la misma nunca están juntas en convoys abiertos.

cuenta · tope

La tripulación

Cada cuenta de Claude tiene un tope de sesiones activas y una pausa. Al llegar al límite, las sesiones traspasan lo que empujaron, con hashes.

convoy approve

El sí del armador

Un convoy con una historia de nivel full o un área crítica espera además tu sí, escrito en tu propia terminal y atado a ese commit.

Cada imagen corresponde a un mecanismo del código de Harbor. La tabla completa, y dónde puede confundir cada imagen, está en la página técnica. Las imágenes, y qué representan →

Probalos

Instalá Keelokit. Cargá Harbor cuando lo necesites.

Keelokit

 claude plugin marketplace add leosimini/keelokit claude plugin install keelokit@keelokit

Después corré /keelokit:project-new en una carpeta vacía, o /keelokit:project-adopt en un repo que ya tenés. Necesitás Node 22 con pnpm 10, Python 3.11+, uv, Docker y git, en macOS o Linux.

Última versión: v0.13.0 · 2 nov 2026 · Novedades · Descargar .zip

Descargá la última versiónCódigo y licencia en GitHub

Keelokit Harbor v0.1.0 · publicado

 claude plugin marketplace add leosimini/keelokit-harbor claude plugin install harbor@keelokit-harbor

Después /harbor:adopt en un proyecto con Keelokit (0.12.0 o posterior). Necesita Python 3.11+, git y un remoto origin.

O descargá harbor-plugin.zip: en Claude, Customize → Plugins → Upload.

Descargá la última versiónCódigo y licencia en GitHub