▶ 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.

▼ How to play ↓ Install
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
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-hosted — `git 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