SpecWeave CLI 3.1.0Gratis y de código abierto
El trabajo sobrevive a la sesión.
Tu agente escribe el código. SpecWeave guarda qué significa «hecho», qué lo demostró y dónde te detuviste, como archivos de texto en git, para que Claude Code, Codex o cualquier otro agente continúe la misma tarea.
npm i -g specweaveVersión 3.1.0, publicada el 17 October 2026. Gratis y de código abierto.
$ specweave pickup Picked up the handoff from claude@cloud (out of tokens): applied 7 uncommitted files. SpecWeave pickup · you are codex@laptop Increment 0001-resumable-checkout "Resumable checkout" (active) · tasks 1/2 done Next: T-02 Restore the draft on return AC-01: Returning within 24 hours restores the cart and shipping choice AC-02: A paid order is never restored Files: src/restore.js | Test: npm test Branch: main · in sync with origin/main · 3 uncommitted files Last handoff: claude@cloud: out of tokens · next: finish restore on return Notes: - claude@cloud: Payment thread: drafts must never store card data
Seis comandos del plan al cierre
Cada paso deja un archivo. Nada se cierra con una casilla marcada: el test se ejecuta, su salida se guarda, y el incremento sigue abierto hasta que la verificación pasa.
01 Planifica el incremento
$ specweave create-increment "Resumable checkout"El agente completa Problem, Scope, criterios de aceptación numerados, Approach y Tasks. Antes de escribir, sw-increment pregunta solo las decisiones que te necesitan, una a una con una respuesta recomendada: como máximo cinco por defecto, y
planning.deepInterviewfija la profundidad.spec.mdCada tarea nombra sus criterios, sus archivos y su test.02 Reclama una tarea
$ specweave task claim T-02La reclamación va al ledger, así que un segundo agente que pida la misma tarea es rechazado. Una reclamación de más de dos horas está caducada y se puede tomar.
specweave task nextimprime la siguiente tarea con el texto de sus criterios.ledger.jsonlSolo se añade: eventos claim, done, release, skip y block.03 Demuestra que está hecho
$ specweave task done T-02 --run "npm test"La CLI ejecuta el test por sí misma. Solo exit 0 registra la tarea como hecha, con el commit y el final de la salida como evidencia. Una ejecución fallida no registra nada.
reports/task-T-02.txtLa salida completa del comando, con su código de salida y su hora.04 Verifica el incremento
$ specweave verifyEjecuta tus comandos de test, lint y build, tomados de
testing.commandso detectados desdepackage.json, Cargo, pytest o Go, y comprueba cada criterio de aceptación.reports/verify.jsonok es true solo cuando pasan todos los comandos y criterios.05 Revisa con el otro modelo
$ specweave reviewEntrega el diff a un revisor de una familia de modelos distinta a la que lo escribió: Codex revisa el código de Claude, y Claude revisa el de OpenAI. Exit 0 significa publicar, exit 3 significa corregir primero.
--briefimprime el resumen para pegarlo en cualquier herramienta. Novedad en 3.1.0; consulta Revisión con otro modelo.reports/review-codex.mdLos hallazgos y el veredicto, con el nombre del revisor.06 Ciérralo
$ specweave complete 0001Se niega mientras
reports/verify.jsonfalte o no esté ok. Cerrar sin él requiere--reason, y el motivo se guarda con el incremento.metadata.jsonCompletado, o el motivo por el que se cerró sin pruebas.
Comandos, opciones y nombres de archivo como en specweave 3.1.0. El incremento, la tarea y el revisor son el ejemplo usado en toda esta página.
Quedarte sin tokens no es el final
Di «hand off» en la herramienta que dejas y «pick up where I left off» en la siguiente. Codex puede continuar lo que empezó Claude Code, en la misma máquina o en otra. No se copia nada entre herramientas: specweave handoff sube una instantánea a specweave-handoff y wip/<branch> y añade un evento al ledger.
handoff --allEscribe un índice de cada incremento activo y de cada repositorio anidado con trabajo solo local.pickup --listMuestra los traspasos pendientes, del más reciente al más antiguo, y no cambia nada.pickup <id o título>Toma uno concreto cuando hay varios esperando.handoff --no-pushMantiene el traspaso en esta máquina en lugar de subirlo a tu remoto.
Sale: Claude Code, como claude@cloud
$ specweave handoff --reason "out of tokens"
Handed off 0001-resumable-checkout (released T-02, pushed your uncommitted edits).
To continue in any tool, machine or account, say "pick up" there (or run `specweave pickup`).
Details: .specweave/increments/0001-resumable-checkout/handoff.mdUna instantánea subida a specweave-handoff y wip/<branch> en tu remoto, más un evento de traspaso en el ledger
Entra: Codex, como codex@laptop
$ specweave pickup Picked up the handoff from claude@cloud (out of tokens): applied 7 uncommitted files. SpecWeave pickup · you are codex@laptop Increment 0001-resumable-checkout "Resumable checkout" (active) · tasks 1/2 done Next: T-02 Restore the draft on return
Las líneas de la retoma son salida real de un segundo clon ejecutándose como Codex. Las líneas del traspaso son el mensaje exacto de la CLI en la misma ejecución.
Límites de uso, resueltos antes de que lleguen
specweave auto-handoff on añade hooks a Claude Code, Codex y Grok Build. Cada hook guarda un punto de control local, y al 95 % de cualquier ventana de uso el modo decide qué pasa (Grok no informa de ningún porcentaje, así que su hook actúa cuando un turno llega a su límite de frecuencia).
suggestPor defecto- En el umbral
- Te avisa una vez de que un traspaso está listo y sigue trabajando.
- Úsalo para
- El valor por defecto. Tú decides cuándo cambiar.
enforce- En el umbral
- Ejecuta specweave handoff y detiene la sesión.
- Úsalo para
- Ejecuciones desatendidas que deben detenerse limpiamente en el límite de una tarea.
checkpoint- En el umbral
- Solo guarda puntos de control locales y nunca hace el traspaso.
- Úsalo para
- Planes en los que los créditos o un proxy siguen funcionando pasado el límite.
--at 90Mueve el umbral; el valor por defecto es 95.--wait-under 30No hace nada cuando todas las ventanas llenas se restablecen en menos de esos minutos; el valor por defecto es 30.autocompact onCompacta Claude Code a los 400K tokens en lugar de cerca del millón, para que los turnos finales sigan siendo pequeños.
¿Ejecutas agentes en SpecWithCode? Usa una máquina por suscripción de proveedor: mantén cada máquina con sesión iniciada en una sola cuenta por proveedor de forma permanente, y añade una máquina cuando necesites más capacidad en lugar de cambiar de suscripción a mano.
Siete skills por defecto, cuatro cuando las necesites
Las skills son instrucciones breves que tu agente carga bajo demanda. Desde 3.1.0, las opcionales se activan cuando tu proyecto las requiere. specweave skills list muestra por qué está activa cada una, y enable o disable lo cambia.
En cada proyecto
sw-increment- Planifica el incremento como un único spec.md y pregunta primero las decisiones críticas.
sw-grill-me- Te entrevista por rondas hasta que se resuelven todas las decisiones de un plan. Con planning.deepInterview en deep, cada incremento nuevo la ejecuta.
sw-do- Trabaja el incremento tarea a tarea: reclama, implementa dentro de sus archivos, prueba, hace commit y marca como hecho con evidencia. En solitario, desatendido o en carriles paralelos.
sw-auto- Ejecuta un incremento sin supervisión hasta que cada tarea está hecha, y luego lo verifica y lo cierra.
sw-review- Una revisión adversarial con un contexto nuevo u otra familia de modelos. Cada hallazgo cita un archivo y una línea.
sw-done- Cierra el incremento: tareas hechas, verify en verde, una revisión con contexto nuevo y luego complete.
sw-handoff- Pasa el trabajo a otra herramienta, cuenta o máquina, y lo retoma allí.
Cuando el proyecto las requiere
sw-glossary- Crea
GLOSSARY.md, las palabras compartidas del proyecto.specweave glossary check --stricthace fallar el CI si hay desviaciones. sw-sync- Publica incrementos en GitHub, Jira o Azure DevOps. Se activa cuando el proyecto tiene un gestor de incidencias.
sw-project- Lee y actualiza el hub del proyecto. Se activa cuando existe
.specweave/project/hub.json. sw-jev- Pasa decisiones de conjunto cerrado a Jev. Se activa cuando
jev.enabledestá definido.
Un registro que puedes inspeccionar
Todo lo anterior son archivos normales de tu repositorio. La revisión de git y los controles de acceso protegen el historial; estos archivos no son un sistema de auditoría a prueba de manipulación.
spec.mdQué significa «hecho»
Se escribe al planificar y se lee antes del código.
ledger.jsonlQué ocurrió
Reclamaciones, finalizaciones con evidencia, notas y traspasos.
reports/Qué lo demostró
Registros de tareas,
verify.md,verify.jsone informes de revisión.handoff.mdDónde te detuviste
Lo escribe
specweave handoff.specweave noteNotas para el siguiente agente
Se guardan en el ledger, y
pickuplas muestra..specweave/memory/Decisiones que sobreviven a la sesión
Un archivo por dato, indexado en
MEMORY.mdy con commit, para que toda herramienta y cuenta lo vea.specweave dashboardUn tablero con todo
Solo local, en 127.0.0.1 puerto 3456 por defecto. Leerlo no requiere ninguna llamada a un modelo.
specweave reportQuién hizo qué, como página
Una línea de tiempo HTML de herramientas, sesiones, traspasos y evidencia en
reports/handoff-report.html.
Lo que lee el panel para el ejemplo
| Incremento | 0001-resumable-checkout Checkout reanudable |
|---|---|
| Estado | Activo |
| Tareas | 1 de 2 hechas |
| Siguiente tarea | T-02 Restaurar el borrador al volver |
| Criterios | AC-01 Volver en menos de 24 horas restaura el carrito y la opción de envío. AC-02 Un pedido pagado nunca se restaura. |
| Archivos y test | src/restore.js, npm test |
| Último traspaso | claude@cloud, sin tokens. Retomado por codex@laptop. |
Creado a partir de la misma ejecución de specweave pickup que se muestra al inicio de esta página. Ejecuta specweave dashboard en tu proyecto para ver el tuyo.
Conectado a las herramientas que ya usas
Cada una es opcional y sigue desactivada hasta que la configures.
Navegación por el código
$ specweave lsp refs src/restore.js restoreDraftReferencias, definiciones, tipos al pasar el cursor y símbolos desde servidores de lenguaje, para que los agentes dejen de usar grep.
Guía de LSPspecweave lsp setupelige servidores para los lenguajes de tu repositorio.Jev
$ specweave jev route "<prompt>"Decisiones de conjunto cerrado en unos 250 ms: qué skill o nivel de modelo, si un comando de shell es seguro de ejecutar, si el texto descargado merece una segunda mirada. Actívalo con
Sobre Jevspecweave jev setup.Hub del proyecto
$ specweave project briefUn objetivo, contexto, artefactos y rutinas compartidos en
Guía de proyectos portátiles.specweave/project/hub.jsonque toda herramienta lee.--harness codexexporta el resumen para otra herramienta.Repositorios existentes
$ specweave get owner/repoClona y registra un repositorio en el espacio de trabajo, o todos los repositorios de una organización con
Guía de adopción del espacio de trabajo--all.--dry-runmuestra de antemano cómo se adoptaría un checkout que ya tienes.Gestores de incidencias
$ specweave sync pushOpcional. Publica un incremento en GitHub Issues, Jira o Azure DevOps cuando tu equipo planifica allí.
Guía de sincronización con gestores
Ejecuta los mismos incrementos en una app de escritorio
Un hilo worker de SpecWithCode trabaja en una rama y abre una pull request, que es justo la forma de un incremento. Su lista de comprobación es la lista de tareas del incremento, y sus escrituras en el ledger son los comandos de esta página. Los hilos se dejan notas en el ledger en lugar de editar los archivos de los demás.
Conoce SpecWithCode