Gentle Shell convierte una sesión de Pi en un espacio de trabajo que dirigís vos: un flujo de desarrollo que escala solo cuando hace falta, subagentes que trabajan en paralelo, verificación según el riesgo y paneles para ver todo lo que pasa. Acá está todo lo que tiene, y lo que medimos contra Codex.
No es ingeniería de prompts. Es disciplina de runtime alrededor de un agente potente: aclarar, explorar, decidir, implementar, verificar y cerrar.
El agente base. Gentle Shell es un paquete de Pi: extensiones, temas, prompts y skills.
Orquestador, persona, modelos, delegación, ODD y toda la interfaz.
Lo instala y es dueño del review nativo: lentes, candidato congelado y aprobación.
Memoria persistente, como compañero opcional. Sobrevive a sesiones y compactaciones.
~/.gentle-shell/agent, o --link para reusar el de Pi.Requiere Pi ≥ 0.99.1 y Node ≥ 22.19.
# standalone (recomendado) $ npm i -g gentle-pi $ gentle-shell # o desde Gentle AI $ gentle-ai install --agent pi # adentro, para arrancar /gentle:status /gentle:doctor
No tenés que pedirlo ni acordarte. Corre solo, y escala solo cuando la tarea lo necesita.
Si se entiende, el riesgo está contenido y alguien podría terminarla con el pedido y el git diff, se hace en el momento: test en rojo, arreglo, suite. Sin ceremonia.
Tarea chica del bench: 1.9 a 2.3 min · Codex 1.8
Explorer, worker y verify corren como procesos de Pi aparte, con contexto limpio. Al orquestador le llega un resumen corto, no cientos de miles de tokens.
subagent_run # task o background subagent_send_message subagent_continue subagent_cancel ## Allowed edit surfaces src/budget/*.ts tests/budget/ /gentle:background-subagents enable
El verify deriva sus propias pruebas de cada regla del pedido, chequea invariantes (un comando rechazado deja los datos idénticos) y ejecuta todo en una copia aislada.
Verify viejo: revisaba los tests del writer.
Verify nuevo: sin falsas alarmas en las soluciones limpias.
Cuatro lentes aisladas miran el cambio sin el contexto del que lo escribió: risk, resilience, readability y reliability. Gentle AI congela el candidato y es dueño de la aprobación; Gentle Shell solo transporta.
Opt-in: /gentle:review-mode enable
En main · sale con la próxima release
Una tarjeta por subagente: modelo, esfuerzo, tokens, costo y tiempo. alt+a abre el detalle, alt+s lo frena.
Builds, CI o servers con bash_background: te avisa cuando terminan. monitor te pasa cada línea mientras corre.
Sesiones que se avisan entre sí y comparten estado publicado, con tu consentimiento. Worktrees del mismo clon registrados en la sesión.
alt+g): lo que escribió la sesión y sus subagentes, por worktree, con diff. Sin escanear el repo./gentle:stats.alt+k.alt+g Changes alt+a agentes alt+k comandos ctrl+shift+r historial /gentle:usage /gentle:stats /gentle:jobs
/gentle:persona: gentleman, con voseo rioplatense, o neutral. El estilo es de la conversación; el código sale siempre en inglés.
/gentle:models: modelo y esfuerzo por agente. Exportar, restaurar y guardar en un perfil.
/gentle:profiles: combinaciones con nombre, orquestador incluido. Fijalos en tu máquina o declaralos en el repo.
Decisiones, bugs y descubrimientos que sobreviven entre sesiones. Una feature grande se retoma desde su documento y su copia en memoria.
Mapa del código para preguntas de estructura: quién llama a quién, dependencias, impacto. Acotado al workspace.
PRs encadenados, commits por unidad, issues, Judgment Day, creador de skills y más. Se registran solas en .atl/skill-registry.md.
Búsqueda y fetch con pi-web-access. Preguntas estructuradas al usuario con opciones, sin adivinar.
/gentle:yolo: commits, push y PRs sin preguntar. Apagado por defecto, dura la sesión. Lo destructivo sigue preguntando, y algunas cosas quedan bloqueadas siempre.
DROP/TRUNCATE, rm recursivo y force de git, vigilados y bloqueados en subagentes. Nada fuera del proyecto sin pedirlo.
Solo host, modelo, esfuerzo, tokens y duración. Nunca prompts, código ni rutas. /gentle:telemetry disable o DO_NOT_TRACK=1.
El historial de prompts también es opt-in: apagado hasta que lo prendés.
Gentle, Gentleman-Cute y Gentleman-Sexy.
Tarjetas neón o flotantes, layout, banner y perfiles visuales.
/gentle:vim para editar el prompt como en casa.
quality, performance o potato, según tu máquina.
Una chica, dos features juntas y una feature con dos entregas en commits revisables.
Una suite que el agente nunca ve. Medimos el costo hasta algo que la pasa, no la primera respuesta.
Soluciones anonimizadas y mezcladas, sin saber de qué agente salió cada una.
Gentle Shell con Sol 6.1 low en todos los roles · Codex CLI con Sol 6.1 y su esfuerzo por defecto
| Caso | Antes | Hoy | Codex |
|---|---|---|---|
| Calidad · chica y mediana | 3.º, debajo de Codex | 1.º · arriba en 4 de 5 | — |
| Calidad · grande | La mejor era la de Codex | 1.º | 2.º |
| Tarea chica | 3.6 min | 1.9 a 2.3 min | 1.8 min |
| Dos features | 10.9 min | 3.2 a 3.6 min · 7.3 con verify | 2.8 min |
| Loop de correcciones | 97 min · USD 3.65 | 19 a 34 min · sin timeout | — |
| Verify en defectos conocidos | 0 de 9 | 8 de 9 · 0 falsas alarmas | — |
| Dos entregas | 2 rondas vacías | 17.5 a 17.9 min · USD 0.68 a 0.74 | 6.1 min · USD 0.23 |
Todas aceptadas en la primera ronda. Corridas únicas o de 2 a 3 repeticiones: tomalo como dirección, no como decimal exacto.
En la tarea de dos entregas, Gentle Shell tarda unas 3 veces lo que Codex. Se va sobre todo en un verify por cada entrega.
Tarea chica, contra Codex. 1.º en calidad.
Dos features, contra Codex. 1.º en calidad.
Dos entregas. 1.º en calidad. La brecha que estamos cerrando.
Trabajo largo, varios frentes: donde los subagentes valen. Se mide aparte.
Release estable: v4.0.0. Todo esto está en main y sale con la próxima versión.
Gentle Shell no te reemplaza el criterio: te da un equipo que explora, escribe, prueba y te dice qué no pudo probar.
github.com/Gentleman-Programming/gentle-shell · gentle-ai.gentlemanprogramming.com