CodexFold
Français

Gardez chaque session Codex. Stockez les répétitions une seule fois.

Au fil des longues sessions, Codex répète les mêmes instructions, les mêmes lectures de fichiers et les mêmes sorties d'outils. CodexFold repère le contenu identique octet pour octet, n'en garde qu'une copie dans un stockage local et vérifie chaque restauration avec le SHA-256 d'origine.

Installer avec Go
go install github.com/samekind/codexfold/cmd/codexfold@v0.4.0-beta.2
Télécharger la préversion Voir le code sur GitHub

Préversion v0.4.0-beta.2. L'outil en ligne de commande fonctionne sous macOS, Linux et Windows. Le système de fichiers transparent s'active sur demande et reste en cours de validation.

Trois sessions, chacune avec sa propre copie du même contenu.

  • Instructions du projet
  • Le même fichier, relu
  • Sortie d'outil répétée
  • Journal collé
  • Contenu propre à une session

Illustration, sans échelle.

Mesuré sur 58 sessions réelles

Un corpus local représentatif de 16,01 Go, avec de grandes sessions actives et archivées. La déduplication exacte l'a réduit de moitié, puis la compression Zstandard a encore divisé le reste par deux.

L'espace disque n'est libéré qu'après le retrait des copies natives et des objets isolés, ce qui n'est pas encore une politique automatique en production. Lire le rapport de validation

Source repliée
15,47 Go
Après déduplication exacte
7,72 Go
Après compression, manifestes inclus
4,36 Go
  • 57 restaurations sur 57 ont retrouvé la taille et le SHA-256 d'origine.
  • 16,0 Go analysés sur trois niveaux de doublons en 303 secondes.
  • 1 session encore en cours d'écriture a été refusée avant la validation de son manifeste.

De l'analyse à la restauration vérifiée

  1. Analyser

    Mesurez les champs, enregistrements et blocs strictement identiques. L'analyse est en lecture seule.

  2. Replier

    Prévisualisez d'abord. Avec --apply, CodexFold écrit les objets partagés et un manifeste versionné. Le fichier de session d'origine reste en place.

  3. Vérifier et restaurer

    doctor contrôle chaque manifeste et chaque objet. unfold reconstruit le fichier et confirme sa taille et son SHA-256 avant de remplacer quoi que ce soit.

$ codexfold scan --all --layers field,record,cdc
sessions=8 corpus=48.69 MiB processed=48.69 MiB skipped=0 appended=0 duration=440ms index=1.00 MiB missing=0 changed=0

LAYER   OBJECTS    UNIQUE     DUPLICATES  DUPLICATE BYTES  CORPUS SHARE
cdc     594        594        0           0 B                0.00%
field   1472       513        959         31.14 MiB         63.97%
record  1960       1480       480         15.56 MiB         31.97%

$ codexfold fold 6a04b768-cdfd-c692-70ce-f666db3df52f
session=6a04b768-cdfd-c692-70ce-f666db3df52f verified=true dry_run=true parts=495 records=0 fields=247 residual=248 new=683.28 KiB removed=false manifest=~/.codex/fold-store/manifests/6a04b768-cdfd-c692-70ce-f666db3df52f.json

$ codexfold fold 6a04b768-cdfd-c692-70ce-f666db3df52f --apply
session=6a04b768-cdfd-c692-70ce-f666db3df52f verified=true dry_run=false parts=495 records=0 fields=247 residual=248 new=683.28 KiB removed=false manifest=~/.codex/fold-store/manifests/6a04b768-cdfd-c692-70ce-f666db3df52f.json

$ codexfold doctor
manifests=1 verified=1 objects=274 issues=0 store=~/.codex/fold-store

$ codexfold unfold 6a04b768-cdfd-c692-70ce-f666db3df52f --to restored.jsonl
session=6a04b768-cdfd-c692-70ce-f666db3df52f verified=true bytes=8.17 MiB target=restored.jsonl
Exécution réelle sur un échantillon synthétique de 8 sessions. Le dossier personnel est abrégé en ~.

Ce que CodexFold fait, et ce qu'il ne fait pas

  • Aucun appel réseau, aucune télémétrie, aucun envoi, aucune requête à un modèle.
  • Identique signifie mêmes octets. Un contenu seulement proche n'est jamais fusionné.
  • L'analyse ne modifie jamais les fichiers de session ni l'état de Codex.
  • fold, gc et la suppression des sources restent des simulations tant qu'aucune option explicite n'est passée.
  • Objets et manifestes passent par des fichiers temporaires et sont validés de façon atomique.
  • Une restauration ne remplace un fichier qu'après vérification complète du SHA-256.

Où il fonctionne aujourd'hui

L'outil en ligne de commande est publié pour macOS, Linux et Windows, en amd64 et arm64, avec sommes de contrôle. Le système de fichiers transparent reste une préversion sur chaque plateforme.

macOS 27 Préversion

Extension FSKit native d'Apple. Compiler l'app demande Xcode 27, une équipe de développement Apple éligible et une signature depuis les sources. Elle n'est pas notariée pour une installation grand public.

Guide du mainteneur

Linux Préversion

Montage FUSE3, validé sans privilèges, avec reprise après plantage et remontage. La validation avec un vrai client Codex reste à faire.

Validation Linux

Windows Préversion

Système de fichiers WinFsp avec une app native dans la zone de notification, à compiler depuis les sources. L'interface Desktop, le redémarrage et le service SYSTEM restent à qualifier.

Guide de la préversion Windows
Télécharger depuis GitHub Releases