Data formatsFormats de données
Where claude-cluster keeps its files, and the format of each: state, transcripts, history, stash, taxonomy, usage, devices.Où claude-cluster garde ses fichiers, et le format de chacun : état, transcriptions, historique, réserve, taxonomie, usage, appareils.
1. FoldersDossiers
| Folder | Default | Override |
|---|---|---|
| config | ~/.config/claude-cluster | CLAUDE_CLUSTER_CONFIG_DIR |
| data | ~/.local/share/claude-cluster | CLAUDE_CLUSTER_DATA_DIR |
| socket | $XDG_RUNTIME_DIR/claude-cluster/control.sock | CLAUDE_CLUSTER_SOCKET |
The config and data folders are 0700. Besides them an installed binary writes its icon and desktop file in the icon theme, and the service its systemd user unit.
| Dossier | Défaut | Remplacement |
|---|---|---|
| config | ~/.config/claude-cluster | CLAUDE_CLUSTER_CONFIG_DIR |
| données | ~/.local/share/claude-cluster | CLAUDE_CLUSTER_DATA_DIR |
| socket | $XDG_RUNTIME_DIR/claude-cluster/control.sock | CLAUDE_CLUSTER_SOCKET |
Les dossiers de config et de données sont en 0700. En dehors d'eux un binaire installé écrit son icône et son fichier desktop dans le thème d'icônes, et le service son unité systemd utilisateur.
2. Config folderDossier de config
| File | Content |
|---|---|
config.toml | the configuration, written commented on the first run; only values change when saved (reference) |
global.md, sessions.md | the system prompts of the global session and of the sub-sessions (copies written once, yours to edit) |
machine.md | the map of this computer |
vocabulary.txt, voice-words.txt | the voice vocabulary and the send / cancel words |
credentials.json | API keys when the keyring is not used (0600) |
web/ | ca.pem and its key (0600), the server certificate, trusted.json, banned.json (0600) |
android/release.jks | the signing key of the Android app |
| Fichier | Contenu |
|---|---|
config.toml | la configuration, écrite commentée au premier lancement ; seules les valeurs changent à la sauvegarde (référence) |
global.md, sessions.md | les prompts système de la session globale et des sous-sessions (copies écrites une fois, à vous d'éditer) |
machine.md | la carte de cet ordinateur |
vocabulary.txt, voice-words.txt | le vocabulaire de la voix et les mots d'envoi / d'annulation |
credentials.json | clés d'API quand le trousseau n'est pas utilisé (0600) |
web/ | ca.pem et sa clé (0600), le certificat du serveur, trusted.json, banned.json (0600) |
android/release.jks | la clé de signature de l'application Android |
3. Data folderDossier de données
| File | Format and content |
|---|---|
state.json | one JSON object: sessions (each: id, name, cwd, backend, claude_id for --resume, model, mode, effort, panels, global, created, cost, tokens, summary, category, tags, turns, pin...), trash, tasks, schedules, next* counters, ui |
logs/<id>.jsonl | the transcript of a session, one JSON entry per line (kept within transcript_limit_mb, 25 MB; in memory its newest entries within memory_mb, 1 MB, all of them within memory_total_mb, 100 MB - the older ones read again from here when its top is reached); logs/archive/ holds conversations ended by /clear; each entry has its origin (user, mcp, task, scheduled) |
history.jsonl | the prompts you sent: {time, session, text, images, pastes} per line, newest history_limit (1000) kept |
stash.json | the stashed prompts, global, with time and session |
taxonomy.json | the forest of categories and tags: node to parent |
usage.jsonl | the ledger of tokens and cost per turn, with the breakdown (input, cache written 5 min / 1 h, cache read, output, thinking) |
stats.jsonl | activity events (start, a sign of life each minute, stop, tool, permission decision, limit, error) |
prices.json, limits.json | prices learned from Claude Code; limit state |
orchestrator.json, hardware.json | the job history (last history); the hardware scan with scan_version |
method.json | work method detection: counter, the proposal waiting |
core.log, debug.log | the core log; the debug trace (only with [debug] enabled) |
attachments/<session>/ | uploaded files, 0600 (Attachments) |
rewind/<session>-<time>.json | what a rewind removed (the old leaf, the removed log lines) |
plugins/ | cloned sources and index.json (Settings) |
icons/ | the SVG faces |
wake.py | the detector of the wake phrase |
| Fichier | Format et contenu |
|---|---|
state.json | un objet JSON : sessions (chacune : id, name, cwd, backend, claude_id pour --resume, model, mode, effort, panels, global, created, cost, tokens, summary, category, tags, turns, pin...), trash, tasks, schedules, compteurs next*, ui |
logs/<id>.jsonl | la transcription d'une session, une entrée JSON par ligne (gardée dans transcript_limit_mb, 25 Mo ; en mémoire ses entrées récentes dans memory_mb, 1 Mo, toutes ensemble dans memory_total_mb, 100 Mo - les plus anciennes relues d'ici quand on remonte en haut) ; logs/archive/ contient les conversations terminées par /clear ; chaque entrée a son origin (user, mcp, task, scheduled) |
history.jsonl | les prompts envoyés : {time, session, text, images, pastes} par ligne, les history_limit (1000) derniers gardés |
stash.json | les prompts mis de côté, global, avec l'heure et la session |
taxonomy.json | la forêt de catégories et tags : nœud vers parent |
usage.jsonl | le registre des tokens et du coût par tour, avec le détail (entrée, cache écrit 5 min / 1 h, cache lu, sortie, réflexion) |
stats.jsonl | événements d'activité (démarrage, signe de vie chaque minute, arrêt, outil, décision de permission, limite, erreur) |
prices.json, limits.json | prix appris de Claude Code ; état des limites |
orchestrator.json, hardware.json | l'historique des travaux (les history derniers) ; le scan du matériel avec scan_version |
method.json | détection de méthode de travail : compteur, proposition en attente |
core.log, debug.log | le journal du cœur ; la trace de debug (seulement avec [debug] enabled) |
attachments/<session>/ | fichiers téléversés, 0600 (Pièces jointes) |
rewind/<session>-<heure>.json | ce qu'un retour en arrière a retiré (l'ancienne feuille, les lignes de journal retirées) |
plugins/ | sources clonées et index.json (Réglages) |
icons/ | les visages en SVG |
wake.py | le détecteur de la phrase de réveil |
4. Transcript entriesEntrées de transcription
An entry of logs/<id>.jsonl is a JSON object {time, kind, text, tool, origin}: kind is a number naming the type of entry (prompt, answer, tool call, thinking, display block, notice...), tool the tool concerned and origin where a prompt came from. The display blocks of the global session (session_display) are stored in it too, so they are searched and exported as text. Old transcripts without origin are read from the markers of their text ([from the global session], [reply from, [scheduled w, [tasks]). claude-cluster export <s> [file] writes Markdown; claude-cluster search <text> searches every history.
Une entrée de logs/<id>.jsonl est un objet JSON {time, kind, text, tool, origin} : kind est un nombre qui nomme le type d'entrée (prompt, réponse, appel d'outil, réflexion, bloc d'affichage, notice...), tool l'outil concerné et origin d'où venait un prompt. Les blocs d'affichage de la session globale (session_display) y sont aussi stockés, donc cherchés et exportés en texte. Les anciennes transcriptions sans origin sont lues d'après les marqueurs de leur texte ([from the global session], [reply from, [scheduled w, [tasks]). claude-cluster export <s> [fichier] écrit du Markdown ; claude-cluster search <texte> cherche dans tous les historiques.
5. InterchangeÉchange
Everything is plain JSON, JSONL, TOML or Markdown: nothing needs claude-cluster to be read. The conversation of the agent itself stays in the agent's own store (for Claude Code ~/.claude/projects): claude-cluster resumes it by id and never rewrites it, except the explicit session_edit and rewind, which write a new conversation next to the old one.
Tout est du JSON, JSONL, TOML ou Markdown simple : rien n'a besoin de claude-cluster pour être lu. La conversation de l'agent lui-même reste dans le stockage propre de l'agent (pour Claude Code ~/.claude/projects) : claude-cluster la reprend par identifiant et ne la réécrit jamais, sauf session_edit et le retour en arrière explicites, qui écrivent une nouvelle conversation à côté de l'ancienne.