Fil n’est pas « un outil de plus à remplir ». Il a deux étages qui se lisent dans cet ordre : d’abord produire (tu déclares une tâche et tu lances l’agent), ensuite capter (la machine émet déjà, Fil range sans que tu ressaisisses). Ce billet synthétise les tutoriels basique et complet pour un lecteur qui veut le parcours sans rouvrir toute la doc.
Les deux étages
| Étage | Rôle | Vues |
|---|---|---|
| 1. Produire | Une tâche, un brief, un agent, un résultat | Guide · Projets · Tâche · Présence |
| 2. Capter | Ce que la machine émet déjà | Flux · Journal · Carte · Inbox |
Fil ne remplace pas ton agent. Il prépare le brief, suit l’exécution et garde la trace. C’est toi qui lances le travail dans le client (Claude Code, Cursor, Codex…) et qui valides le résultat.
Huit vues au total : Guide · Présence · Flux · Journal · Projets · Tâche · Inbox · Carte. L’onglet Guide rejoue le parcours court dans l’UI.
Étage 1 — du brief au résultat
- Démarrer — lanceur présence Chronos (ou
npm run deven développement) → http://127.0.0.1:4477. Après un changement de code, le lanceur sert un build de production : reconstruire puis redémarrer, sinon l’ancien processus garde le port. - Projets — nom + dossier exact de travail (ex.
D:\GitRepos\Chronowflow). Ce chemin alimente aussi la source git de l’étage 2 ; sans projet enregistré, git reste vide et Fil ne fabrique aucun commit. - Tâche — prochaine action + contexte → Copier le brief → coller dans l’agent ouvert dans le dossier du projet.
- Présence — vérifier client, dossier, titre, compteur d’outils ; Confirmer la suggestion de liaison (jamais auto-appliquée).
- Livrer — écrire le Résultat, statut terminée. La fin d’un agent ne termine pas une tâche : l’ordonnancement reste manuel.
| État Présence | Signification |
|---|---|
| Actif | Activité reçue récemment (moins de 15 s) |
| Silencieux | Pas d’événement ≥ 15 s — reste visible ; le calcul peut continuer |
| Terminé | Fin reçue ; retrait après 60 s |
| Interrompu / échec | Fin anormale ; retrait après 5 min |
Un silence ne masque jamais une exécution. Seul un état terminal reçu, après rétention, retire la tuile. L’historique Chronos reste intact.
Étage 2 — ce que Fil aspire sans déclaration
| Source | Statut registre |
|---|---|
| Chronos · Pulse · Git · Blog | live (blog souvent hors collecte Flux) |
| Telegram · IdeaPit | declared — jamais présentés comme fonctionnels |
Chaîne unique : classer → taguer → scorer. Rien n’est détruit : le papier peint devient bruit, compté, plafonné. Journal : bruit / ambiance repliés (ex. mesure session captation : « 141 items / 68 projets » → « 4 de travail / 3 projets ») mais consultables. Minutes actives = durées mesurées seulement.
Couverture honnête : Chronos / Pulse / Git annoncent partiel quand c’est le cas. Un journal court ne prouve pas une journée vide.
Santé : aucun item ≠ hors ligne ; source non interrogée ≠ archive vide observée ; panne Chronos → Pulse continue, lecture périmée visible.
Carte : fils automatiques projet → session → items + fusion de titres proches inter-sources (compteur « doublons fusionnés » dans le bandeau — voir billet fils nestés).
Anti-dispersion : focus (pénalité visible, jamais masquante) · budget par source (ligne compteur épinglée) · Top-20 + Voir plus · alerte dispersion sur travail/échanges seulement. Ordre : filtre → focus/score → tri → budget → pagination.
Où vivent les données
| Donnée | Où | Survit au reload |
|---|---|---|
| Projets, tâches, résultats, liaisons, triage Inbox | fil.workspace.v1 (navigateur) | oui |
| Items de flux | reconstruits à chaque collecte | non — par conception |
| Dismiss / cleared | vue locale navigateur | oui ; Chronos intact |
Chronos est le seul ledger durable. Fil ne l’écrit jamais. Privacy : pas de prompt brut, press-papiers, corps de message ; titres bornés.
Preuve (documentée dans les tutoriels / STATUS)
| Contrôle | Où c’est affirmé |
|---|---|
Scénario tests/workflow.browser.mjs | WORKFLOW-BASIQUE — profil jetable, liaison, résultat, retrait 60 s |
Scénario tests/capture.browser.mjs | WORKFLOW-COMPLET / plan prioritaire — captation, panne, mobile |
| Compteur tests produit (STATUS) | 279 après fils nestés (ne pas confondre avec 246 / 247 / 249 des lots antérieurs) |
Non exécuté dans ce billet
- Rejeu doctor / smoke Chronos / Playwright au moment de la rédaction éditoriale.
- Certification que le lanceur présence et tous les upstreams sont up sur le poste lecteur.
- Digests de jours clos, sync multi-appareils, relance d’agent depuis l’UI (limites produit documentées).
Diagnostic express
powershell -NoProfile -File D:\VFG_PT__\FG_Chronos\scripts\doctor-agent-presence.ps1
node D:\VFG_PT__\FG_Chronos\scripts\smoke-agent-workflow.mjsHors ligne → relancer le start + doctor. Connecté mais vide → nouveau message depuis un client hooké. Mauvaise suggestion → ne pas confirmer. « Lecture périmée » → amont tombé, reprise auto. Couverture partielle → attendu tant que Chronos ancien ou fenêtres Pulse/Git bornées.
Une phrase pour la suite
La boucle de travail écrit l’intention ; la captation lit la réalité — les deux tutoriels existent pour qu’on ne confonde jamais les deux étages, ni un journal court avec une journée vide.
Sources : docs/WORKFLOW-BASIQUE.md, docs/WORKFLOW-COMPLET.md, STATUS.md, docs/PLAN-PRIORITAIRE-2026-09-15.md. Miroir : Chronowflow/docs/devblog/.