1UP · KRONN KRONN FR · EN · ES
▶ INSERT 0 TOKENS TO START ◀

MANY AGENTS.
ZERO CHAOS.

beaucoup d'agents · zéro chaos

Tu jongles avec plusieurs CLI IA (Claude Code, Codex, Gemini, Ollama) sur plusieurs projets. Kronn apporte la mémoire partagée, l'orchestration et la continuité. Local-first. 0 token sur les étapes mécaniques.

v0.8.6 · early access · l'API et les step types peuvent encore bouger avant la v1.0
LEVEL 1 · THE BRIDGE

Un seul cerveau.
Tous tes CLI branchés dessus.

Quatre CLI IA qui s'ignorent. Trois configs MCP qui divergent. Quatorze prompts copiés-collés. État de l'art accepté. Kronn propose un cerveau partagé, local, branché à tout.

· SYSTEM MAP ·
Claude Code
Codex
Gemini
Ollama
KRONN
shared brain · local-first
Mémoire vivante

Discussions persistées en local. Mêmes contextes repris par n'importe quel CLI, OU N CLIs dans une même conversation live.

Prompts

Quick Prompts versionnés, mesurés, ✨ Improver IA.

Routage

Steps mécaniques sans agent. Coût IA = 0 token.

LEVEL 2 · REALITY CHECK

L'avant.
L'après.

Voici ce que tu fais aujourd'hui, et ce que Kronn fait à ta place.

Sans Kronn
  • Tes prompts copiés-collés entre trois fichiers Notion et un Markdown poussiéreux.
  • Switch Claude Code → Codex provoque un reset complet du contexte.
  • Tu sers de messenger entre les agents en copy-pastant chaque message manuellement entre 3 fenêtres.
  • Trois configurations MCP maintenues en parallèle, divergence garantie.
  • Une notification Slack passe par un agent, donc consomme des tokens à chaque envoi.
  • Envoyer un mail ou pousser un log passe aussi par un agent (MCP mail, plugin), tokens à chaque appel.
  • Tu ré-expliques ton architecture à chaque nouvelle discussion.
Avec Kronn
  • Quick Prompts versionnés avec {{vars}}, métriques par itération.
  • Même discussion, transmise au CLI suivant via MCP, zéro copy-paste.
  • 3 CLIs (Claude, Codex, Gemini...) dialoguent dans une seule disc Kronn via disc_join. Zéro messenger humain.
  • Une seule interface, propagation automatique vers tous les CLI installés.
  • Step Notify exécuté sans agent : zéro token.
  • Step ApiCall (Resend, Mailjet, webhook log) : zéro token, l'API directe sans LLM.
  • docs/AGENTS.md généré par audit, lu auto par chaque agent.
▸ Fig. I · décomposition
Mega-prompt vs Kronn workflow · même résultat, 5× moins cher Diagramme à deux lignes. Ligne du haut : l'anti-pattern habituel, un mega-prompt qui demande douze choses d'un coup à un agent, environ douze mille tokens, fragile, debug impossible. Ligne du bas : l'approche Kronn, cinq steps séquentiels (ApiCall, Agent, Exec, Agent, Notify) dont trois déterministes à zéro token et deux steps Agent bornés. Même résultat, cinq fois moins cher. L'approche habituelle · un mega-prompt « Fais les 12 choses » fetch + analyse + write + test + review + commit + notify… 💸 beaucoup (trop) de tokens · imprévisible Boîte noire IA 12 préoccupations en 1 appel ❌ debug = impossible Output on espère ? L'approche Kronn · décompose, code quand tu peux, IA quand tu dois ApiCall fetch ticket 0 token Agent draft impl N tokens Exec cargo test 0 token Agent review diff N tokens Notify webhook 0 token Meilleur résultat moins de tokens 5 steps · 3 déterministes (0 token) · l'IA n'intervient que sur les 2 steps de raisonnement → moins d'hallucinations · plus rapide · coût prévisible · debuggable
KRONN STATEMENT

Tu écris encore tes prompts au feeling.
Tu copies-colles ton contexte d'un agent à l'autre.
Tu paies l'IA pour envoyer un webhook Slack.
Tu maintiens trois configs MCP qui divergent dès que tu clignes des yeux.

Stop.

Kronn termine cette ère.

LEVEL 3 · LOADOUT

Tout ce qu'il y a
dans la borne.

Pas de roadmap, pas de soon™. Tout est shippé, dans le code, vérifiable. Liste exhaustive des briques que Kronn met à ta disposition aujourd'hui.

01Mémoire & contexte
  • Discussions persistées en local (SQLite)
  • Reprise cross-CLI : Claude exporte, Codex reprend (0.8.4)
  • Multi-CLI live : N agents dans une même discussion (0.8.6)
  • docs/AGENTS.md généré par audit
  • Injection user-context ~/.kronn/user-context/
  • Linked repos : contexte multi-repo
  • State canonique .kronn.json par projet
  • Anti-secret filter sur l'audit
02Quick Prompts
  • Variables {{vars}} + sections conditionnelles
  • Versioning + métriques tokens · durée · coût
  • Diff visuel entre versions
  • ✨ Improver IA : suggère et déploie en 1 clic
  • Compare across N agents en parallèle
  • Chains : DnD reorder + {{previous_qp.output}}
  • Binding profile · skill · directive
03Workflows
  • 7 step types : Agent · ApiCall · Batch · Notify · Exec · Gate · BatchQP
  • 0 token sur les steps mécaniques (par définition)
  • AI Workflow Architect : dry-run + 1 clic
  • Batch workflows (fan-out · chaining · git worktree · diff intégré)
  • Loops + state scratchpad + guards
  • Rollback on failure
  • CRON-schedulable : workflows full-auto
  • AutoPilot loop (audit → tickets → workflow)
  • Feasibility-Gated implementation
  • Export / Import per-item
04Agents · plugins · local
  • 7+ CLI supportés (Claude Code · Codex · Gemini · Ollama · Vibe…)
  • Eco mode via RTK : proxy token-killer en 1 clic sur agents supportés
  • Ollama 100 % local + TTS Piper / STT Whisper (FR · EN · ES)
  • Plugins MCP : Atlassian · Linear · Notion · …
  • Plugins API : Resend · Mailjet · webhooks
  • Custom API plugin : déclare tes propres endpoints
  • Multi-user P2P (chat + discs partagées)
  • Desktop app Tauri (Mac · Windows · Linux)
  • AGPL-3.0 · pas de télémétrie · pas de cookies
▸ KRONN PATTERN · PLUGINS
Plugin MCP
l'agent explore
Atlassian · Linear · Notion · Confluence · Stripe …
AI Helper
bascule MCP → API
agent dédié, dialogue guidé pour générer le plugin API
Plugin API
déterministe · 0 token
Resend · Mailjet · webhooks · Custom API …

Tu commences avec un plugin MCP, l'agent comprend comment le vendor répond, teste, itère. Quand la séquence se stabilise, un AI Helper dédié t'accompagne pour basculer sur un plugin API : l'IA sort de la boucle, l'exécution devient déterministe et gratuite en tokens.

LEVEL 4 · COMPOUND EFFECTS

Cinq mécanismes
structurels.

Pas des promesses chiffrées, juste les briques qui permettent à un usage régulier de faire baisser le coût et monter la qualité. Chacune est dans le code, reproductible, vérifiable.

01
Audit

Scan complet du projet : stack, conventions, dettes techniques. Génère docs/AGENTS.md tier-loaded. AutoPilot (activable) transforme les dettes en tickets Jira via MCP puis pré-configure le workflow de traitement en 1 clic.

02
Mémoire

Discussions persistées en local + 10 outils MCP disc_* pour reprise bidirectionnelle cross-CLI. Le CLI suivant lit ET enrichit le fil, pas juste consult.

03
User-context

Tes préférences globales (style de commit, conventions, anti-patterns) vivent dans ~/.kronn/user-context/. Tous tes projets en bénéficient automatiquement. Chaque préférence ajoutée → effet partout.

04
Quick Prompts

Prompts réutilisables avec {{vars}}. Versionnés et mesurés (tokens · durée · coût). Tu améliores, tu compares, tu choisis.

05
Workflows

Orchestration step-based : step Agent + 5 mécaniques (Exec, Gate, Notify, ApiCall) à 0 token par définition. CRON-schedulable. Pattern Feasibility-Gated pour gros tickets : triage YAML → human Gate → code constraint.

LEVEL 5 · NOT INCLUDED

Ce que Kronn n'est pas.

Stater les exclusions, c'est gagner les sceptiques. Voici ce que Kronn n'a pas vocation à être.

×Pas un IDE

Garde Cursor, VSCode, Vim, ou Aider pour le pair-prog CLI. Kronn s'orchestre par-dessus, ne remplace pas ton éditeur, même si tu peux faire pas mal de choses depuis Kronn : git worktree, accès diff, exec direct, gates humains ;)

×Pas un LLM

Tu apportes Anthropic, OpenAI, Google, ou Ollama 100% local. Kronn ne t'enferme dans aucun.

×Pas un SaaS

Desktop app local-first. Tes données, prompts et discussions ne quittent pas ta machine.

×Pas un framework

Tu pilotes via UI, tu ne codes pas. Multi-CLI orchestré, pas LangGraph en Python.

×Pas un workflow tool général

Pour automatiser des intégrations non-IA (Slack, ETL, CRM, lifecycle email), garde n8n ou Zapier. Kronn vise l'orchestration d'agents IA spécifiquement.

×Pas un CI/CD

Pour build, deploy, lint sur git, garde GitHub Actions. Kronn orchestre des CLI agents IA local-first, pas du pipeline cloud lié au repo.

LEVEL 6 · QUICKSTART

5 minutes.
4 étapes.

OK, convaincu·e ? Voici l'installation locale. À la fin tu as un projet auditté, une Quick Prompt mesurée, et tes discussions qui survivent au switch entre 2 CLI.

STAGE 01
Install

Deux installations possibles :
Desktop app — télécharge le binaire (Mac, Windows, Linux) sur les releases.
Self-hostedgit clone -b <tag> puis kronn start (CLI / headless, idéal équipe).
Local-first dans les deux cas. Métriques agents en local (QPs, runs, tokens, coût) — jamais de télémétrie cloud.

↓ Releases
STAGE 02
Audit

Ouvre Kronn, ajoute ton projet, lance l'audit avec Briefing (≈ 2 min de Q&A guidé). Kronn scanne ensuite ta stack, détecte les conventions, identifie les dettes techniques et génère docs/AGENTS.md tier-loaded.

Lancement : 2 min. Scan en arrière-plan : 20-30 min sur projet moyen, plus sur monorepo. AutoPilot prêt après pour transformer les dettes en tickets.

STAGE 03
Quick Prompt

Onglet Automation, crée une Quick Prompt. Mets une variable {{ticket}} dans le template. Lance-la sur un agent : Kronn enregistre tokens, durée, coût.

Tu peux lancer la même Quick Prompt sur N agents en parallèle pour comparer les sorties.

STAGE 04
Workflow depuis un template

Onglet Automation → Workflows, clique Nouveau et choisis un preset (Ticket-to-PR, Feasibility-Autopilot, Feature Planner…). Kronn pré-remplit les étapes Brief → Architecture → Code → Tests → Review avec leurs Gates humaines. Tu n'as plus qu'à valider à chaque Gate.

Les Quick Prompts de STAGE 03 peuvent servir de building blocks dans tes workflows custom.

LEVEL 7 · CONCEPTS

Le vocabulaire
technique.

Huit termes qui reviennent partout dans Kronn. Glossaire rapide pour décrypter le reste : ce que c'est, à quoi ça sert.

Quick Prompt

Template de prompt réutilisable avec variables {{ticket}}, {{contexte}}. Versionné. Métriques enregistrées par version (tokens, durée, coût). Bouton ✨ Improver pour itérer avec l'IA.

QP Chain

Séquence de Quick Prompts. Chaque QP peut référencer {{previous_qp.output}} pour chaîner la sortie précédente. Réordonnable en drag & drop.

MCP

Model Context Protocol — standard ouvert (par Anthropic) qui permet aux agents IA d'accéder à des outils externes. Kronn s'appuie sur MCP pour bridger les CLI et exposer ses propres outils via kronn-internal.

StepType

Les 7 types de step disponibles dans un workflow : 2 IA (Agent, BatchQuickPrompt) et 5 mécaniques (ApiCall, BatchApiCall, Notify, Exec, Gate) à 0 token.

AutoPilot

Boucle activable post-audit : Kronn détecte les dettes techniques, crée les tickets Jira via MCP, pré-configure un workflow pour les traiter. Tu cliques, ça roule.

Feasibility-Gated

Pattern d'implémentation pour gros tickets : Kronn génère un manifest YAML de faisabilité, puis un human Gate (tu valides ou rejettes), ensuite l'agent code en suivant le manifest. Zéro surprise.

docs/AGENTS.md

La source canonique de doc d'un projet Kronn. Générée par l'audit. Tier-loaded (light en permanence, sections on-demand). Lue auto par chaque CLI qui ouvre le projet.

Plugin

4 saveurs : MCP (vendor expose un serveur, ex Atlassian), API (vendor API-only packagé, ex Resend), Hybrid (les deux), Custom API (tu déclares tes propres endpoints).

LEVEL 8 · SECURITY & PRIVACY

Ta machine.
Tes données.

Local-first par défaut. Pas de télémétrie, pas de cookies, pas de serveur Kronn. Voici ce qui est protégé, et ce qu'on n'a pas encore : honnêteté avant le sceau de certif.

Local-First
  • SQLite DB locale dans ~/.kronn/
  • Discussions, QPs, audits, configs : tout sur ta machine
  • Pas de cloud sync, pas de télémétrie, pas de cookies
  • Tes données ne sortent que si TU lances un workflow qui appelle un LLM cloud
Secrets & clés
  • API keys stockées dans le keychain OS (Mac/Windows/Linux)
  • Anti-secret filter sur l'audit : .env et prefixes vendor filtrés avant docs/AGENTS.md
  • Aucune variable d'env Kronn poussée vers les CLI tiers
Exec & Gate
  • Step Exec gated par exec_allowlist du workflow (argv literal, pas de sh -c)
  • Step Gate human-in-the-loop : l'agent attend ta validation explicite
  • Audit log : chaque run persisté avec timestamp, tokens, steps exécutés
Ce qu'on n'a pas
  • Pas encore en v1.0 stable. Version actuelle v0.8.6, early access. L'API, les step types et les schémas peuvent évoluer entre versions.
  • Pas de certification SOC2 ni GDPR à ce jour
  • Single-user — pas de RBAC ni team management
  • Si tu utilises Anthropic / OpenAI / Google, tes prompts vont chez eux : leur responsabilité, pas la nôtre
  • AGPL-3.0 → code auditable, mais pas d'audit de sécu externe à ce stade