▶ INSERT 0 TOKENS TO START ◀

# MANY AGENTS.
ZERO CHAOS.

muchos agentes · cero caos

Manejas varios CLI de IA (Claude Code, Codex, Gemini, Ollama) en varios proyectos. Kronn aporta la memoria compartida, la orquestación y la continuidad. Local-first. 0 tokens en los pasos mecánicos.

▼ How to play ↓ Install
v0.8.6 · early access · la API y los step types pueden cambiar antes de la v1.0
LEVEL 1 · THE BRIDGE

## Un solo cerebro.
Todos tus CLI conectados a él.

Cuatro CLI de IA que se ignoran. Tres configs MCP que divergen. Catorce prompts copiados y pegados. Estado del arte aceptado. Kronn propone un cerebro compartido, local, conectado a todo.

· SYSTEM MAP ·
Claude Code
Codex
Gemini
Ollama
▼
KRONN ◆
shared brain · local-first
▼
Memoria viva

Discusiones persistidas en local. Mismo contexto retomado por cualquier CLI, O N CLIs en una misma conversación en vivo.

Prompts

Quick Prompts versionados, medidos, ✨ Improver IA.

Enrutamiento

Pasos mecánicos sin agente. Coste IA = 0 tokens.

LEVEL 2 · REALITY CHECK

## El antes.
El después.

Esto es lo que haces hoy, y lo que Kronn hace en tu lugar.

Sin Kronn

- Tus prompts copiados y pegados entre tres archivos de Notion y un Markdown polvoriento.
- Cambiar de Claude Code a Codex provoca un reseteo completo del contexto.
- Haces de mensajero entre los agentes, copiando y pegando manualmente cada mensaje entre 3 ventanas.
- Tres configuraciones MCP mantenidas en paralelo, divergencia garantizada.
- Una notificación de Slack pasa por un agente, así que consume tokens en cada envío.
- Enviar un email o publicar un log también pasa por un agente (MCP mail, plugin), tokens en cada llamada.
- Vuelves a explicar tu arquitectura en cada nueva discusión.

Con Kronn

- Quick Prompts versionados con `{{vars}}`, métricas por iteración.
- Misma discusión, transmitida al siguiente CLI vía MCP, cero copia y pega.
- 3 CLIs (Claude, Codex, Gemini…) dialogan en una sola discusión Kronn vía `disc_join`. Cero mensajero humano.
- Una sola interfaz, propagación automática hacia todos los CLI instalados.
- Paso `Notify` ejecutado sin agente: cero tokens.
- Paso `ApiCall` (Resend, Mailjet, log webhook): cero tokens, la API directa sin LLM.
- `docs/AGENTS.md` generado por auditoría, leído auto por cada agente.

▸ Fig. I · décomposition
KRONN STATEMENT

Sigues escribiendo tus prompts al tuntún.
Copias y pegas tu contexto de un agente a otro.
Pagas la IA para enviar un webhook de Slack.
Mantienes tres configs MCP que divergen apenas pestañeas.

Stop.

Kronn pone fin a esta era.

LEVEL 3 · LOADOUT

## Todo lo que viene
en la caja.

Sin roadmap, sin soon™. Todo está shippeado, en el código, verificable. Lista exhaustiva de los bloques que Kronn pone a tu disposición hoy.

01Memoria y contexto

- Discusiones persistidas en local (SQLite)
- Continuación cross-CLI: Claude exporta, Codex retoma (0.8.4)
- Multi-CLI en vivo: N agentes en una misma discusión (0.8.6)
- `docs/AGENTS.md` generado por auditoría
- Inyección user-context `~/.kronn/user-context/`
- Linked repos : contexte multi-repo
- Estado canónico `.kronn.json` por proyecto
- Filtro anti-secretos en la auditoría

02Quick Prompts

- Variables `{{vars}}` + secciones condicionales
- Versionado + métricas tokens · duración · coste
- Diff visual entre versiones
- ✨ Improver IA : suggère et déploie en 1 clic
- Compare across N agentes en paralelo
- Chains: DnD reorder + `{{previous_qp.output}}`
- Binding profile · skill · directive

03Workflows

- 7 step types: Agent · ApiCall · Batch · Notify · Exec · Gate · BatchQP
- 0 tokens en los pasos mecánicos (por definición)
- AI Workflow Architect : dry-run + 1 clic
- Batch workflows (fan-out · chaining · git worktree · diff integrado)
- Loops + state scratchpad + guards
- Rollback on failure
- CRON-schedulable : workflows full-auto
- AutoPilot loop (audit → tickets → workflow)
- Feasibility-Gated implementation
- Export / Import per-item

04Agentes · plugins · local

- 7+ CLI soportados (Claude Code · Codex · Gemini · Ollama · Vibe…)
- Eco mode vía RTK: proxy token-killer en 1 clic en agentes soportados
- Ollama 100% local + TTS Piper / STT Whisper (FR · EN · ES)
- Plugins MCP: Atlassian · Linear · Notion · …
- Plugins API: Resend · Mailjet · webhooks
- Custom API plugin · declara tus propios endpoints
- Multi-usuario P2P (chat + discs compartidos)
- App desktop Tauri (Mac · Windows · Linux)
- AGPL-3.0 · sin telemetría · sin cookies

▸ KRONN PATTERN · PLUGINS
Plugin MCP
el agente explora
Atlassian · Linear · Notion · Confluence · Stripe …
→
⚡
AI Helper
cambio MCP → API
agente dedicado, diálogo guiado para generar el plugin API
→
Plugin API
determinista · 0 tokens
Resend · Mailjet · webhooks · Custom API …

Empiezas con un plugin MCP, el agente entiende cómo responde el vendor, prueba, itera. Cuando la secuencia se estabiliza, un AI Helper dedicado te acompaña para cambiar a un plugin API: la IA sale del bucle, la ejecución se vuelve determinista y gratuita en tokens.

LEVEL 4 · COMPOUND EFFECTS

## Cinco mecanismos
estructurales.

Sin promesas en cifras, solo los bloques que permiten que un uso regular reduzca el coste y eleve la calidad. Cada uno está en el código, reproducible, verificable.

01
Auditoríaoría

Escaneo completo del proyecto: stack, convenciones, deuda técnica. Genera `docs/AGENTS.md` tier-loaded. AutoPilot (opt-in) convierte la deuda en tickets de Jira vía MCP y preconfigura el workflow de tratamiento en 1 clic.

02
Memoria

Discusiones persistidas en local + 10 herramientas MCP `disc_*` para continuación bidireccional cross-CLI. El siguiente CLI lee Y enriquece el hilo, no solo consulta.

03
User-context

Tus preferencias globales (estilo de commit, convenciones, anti-patrones) viven en `~/.kronn/user-context/`. Todos tus proyectos se benefician automáticamente. Cada preferencia añadida → efecto en todas partes.

04
Quick Prompts

Prompts reutilizables con `{{vars}}`. Versionados y medidos (tokens · duración · coste). Iteras, comparas, eliges.

05
Workflows

Orquestación step-based: paso `Agent` + 5 mecánicos (`Exec`, `Gate`, `Notify`, `ApiCall`) a 0 tokens por definición. CRON-schedulable. Patrón Feasibility-Gated para tickets grandes: triaje YAML → human Gate → código restringido.

LEVEL 5 · NOT INCLUDED

## Ce que Kronn n'est pas.

Decir lo que no es gana a los escépticos. Esto es lo que Kronn no pretende ser.

×No es un IDE

Sigue con Cursor, VSCode, Vim o Aider para el pair-prog CLI. Kronn orquesta por encima, no reemplaza tu editor, aunque puedes hacer bastante desde Kronn: git worktree, acceso al diff, exec directo, gates humanos ;)

×No es un LLM

Tú aportas Anthropic, OpenAI, Google u Ollama 100% local. Kronn no te encierra en ninguno.

×No es un SaaS

App desktop local-first. Tus datos, prompts y discusiones no salen de tu máquina.

×No es un framework

Pilotas vía UI, no programas. Multi-CLI orquestado, no LangGraph en Python.

×No es un workflow tool general

Para automatizar integraciones no-IA (Slack, ETL, CRM, lifecycle email), quédate con n8n o Zapier. Kronn apunta a la orquestación de agentes IA específicamente.

×No es un CI/CD

Para build, deploy, lint sobre git, quédate con GitHub Actions. Kronn orquesta CLI agentes de IA local-first, no pipelines cloud atados al repo.

LEVEL 6 · QUICKSTART

## 5 minutos.
4 etapas.

OK, ¿convencido/a? Aquí está la instalación local. Al final tienes un proyecto auditado, una Quick Prompt medida, y discusiones que sobreviven al cambio entre 2 CLI.

STAGE 01
Install

Dos instalaciones posibles:
App desktop · descarga el binario (Mac, Windows, Linux) desde las releases.
Self-hosted · `git clone -b <tag>` y luego `kronn start` (CLI / headless, ideal para equipo).
Local-first en ambos casos. Métricas de agentes en local (QPs, runs, tokens, coste) · nunca telemetría cloud.

↓ Releases
STAGE 02
Auditoría

Abre Kronn, añade tu proyecto, lanza la auditoría con Briefing (≈ 2 min de Q&A guiado). Kronn luego escanea tu stack, detecta las convenciones, identifica la deuda técnica y genera `docs/AGENTS.md` tier-loaded.

Lanzamiento: 2 min. Escaneo en segundo plano: 20-30 min en un proyecto medio, más en un monorepo. AutoPilot listo después para convertir la deuda en tickets.

STAGE 03
Quick Prompt

Pestaña Automation, crea una Quick Prompt. Pon una variable `{{ticket}}` en el template. Lánzala en un agente: Kronn registra tokens, duración, coste.

Puedes lanzar la misma Quick Prompt en N agentes en paralelo para comparar las salidas.

STAGE 04
Workflow desde una plantilla

Pestaña Automation → Workflows, haz clic en Nuevo y elige un preset (Ticket-to-PR, Feasibility-Autopilot, Feature Planner…). Kronn pre-rellena los pasos `Brief → Architecture → Code → Tests → Review` con sus Gates humanas. Solo tienes que aprobar en cada Gate.

Las Quick Prompts del STAGE 03 funcionan como bloques reutilizables dentro de tus workflows custom.

LEVEL 7 · CONCEPTS

## El vocabulario
técnico.

Ocho términos que aparecen por todas partes en Kronn. Glosario rápido para descifrar el resto: qué es, para qué sirve.

Quick Prompt

Template de prompt reutilizable con variables `{{ticket}}`, `{{contexto}}`. Versionado. Métricas registradas por versión (tokens, duración, coste). Botón ✨ Improver para iterar con la IA.

QP Chain

Secuencia de Quick Prompts. Cada QP puede referenciar `{{previous_qp.output}}` para encadenar la salida anterior. Reordenable con drag & drop.

MCP

Model Context Protocol · estándar abierto (de Anthropic) que permite a los agentes IA acceder a herramientas externas. Kronn se apoya en MCP para conectar los CLI y exponer sus propias herramientas vía `kronn-internal`.

StepType

Los 7 tipos de step disponibles en un workflow: 2 IA (`Agent`, `BatchQuickPrompt`) y 5 mecánicos (`ApiCall`, `BatchApiCall`, `Notify`, `Exec`, `Gate`) a 0 tokens.

AutoPilot

Bucle opt-in post-auditoría: Kronn detecta la deuda técnica, crea los tickets de Jira vía MCP, preconfigura un workflow para tratarla. Haces clic, listo.

Feasibility-Gated

Patrón de implementación para tickets grandes: Kronn genera un manifest YAML de viabilidad, luego un human Gate (apruebas o rechazas), después el agente codifica siguiendo el manifest. Cero sorpresas.

docs/AGENTS.md

La fuente canónica de doc de un proyecto Kronn. Generada por la auditoría. Tier-loaded (light siempre, secciones on-demand). Leída auto por cada CLI que abre el proyecto.

Plugin

4 sabores: MCP (vendor expone un servidor, ej. Atlassian), API (vendor API-only empaquetado, ej. Resend), Hybrid (ambos), Custom API (declaras tus propios endpoints).

LEVEL 8 · SECURITY & PRIVACY

## Tu máquina.
Tus datos.

Local-first por defecto. Sin telemetría, sin cookies, sin servidor Kronn. Esto es lo que está protegido, y lo que aún no tenemos: honestidad antes que el sello de certificación.

Local-first

- DB SQLite local en `~/.kronn/`
- Discusiones, QPs, auditorías, configs: todo en tu máquina
- Sin sincronización cloud, sin telemetría, sin cookies
- Tus datos solo salen si TÚ lanzas un workflow que llame a un LLM cloud

Secretos y claves

- API keys almacenadas en el keychain del SO (Mac/Windows/Linux)
- Filtro anti-secretos en la auditoría : `.env` et prefixes vendor filtrés avant `docs/AGENTS.md`
- Ninguna variable env Kronn empujada hacia los CLI terceros

Exec y Gate

- Paso `Exec` gated por `exec_allowlist` del workflow (argv literal, sin `sh -c`)
- Paso `Gate` human-in-the-loop: el agente espera tu validación explícita
- Audit log: cada run persistido con timestamp, tokens, steps ejecutados

Lo que no tenemos

- Aún no en v1.0 estable. Versión actual v0.8.6, early access. La API, los step types y los esquemas pueden evolucionar entre versiones.
- Sin certificación SOC2 ni GDPR a día de hoy
- Single-user · sin RBAC ni gestión de equipos
- Si usas Anthropic / OpenAI / Google, tus prompts van a ellos: su responsabilidad, no la nuestra
- AGPL-3.0 → código auditable, pero sin auditoría de seguridad externa en este momento