claude-cluster docs1.10.1
ReferenceRéférence

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

FolderDefaultOverride
config~/.config/claude-clusterCLAUDE_CLUSTER_CONFIG_DIR
data~/.local/share/claude-clusterCLAUDE_CLUSTER_DATA_DIR
socket$XDG_RUNTIME_DIR/claude-cluster/control.sockCLAUDE_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.

DossierDéfautRemplacement
config~/.config/claude-clusterCLAUDE_CLUSTER_CONFIG_DIR
données~/.local/share/claude-clusterCLAUDE_CLUSTER_DATA_DIR
socket$XDG_RUNTIME_DIR/claude-cluster/control.sockCLAUDE_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

FileContent
config.tomlthe configuration, written commented on the first run; only values change when saved (reference)
global.md, sessions.mdthe system prompts of the global session and of the sub-sessions (copies written once, yours to edit)
machine.mdthe map of this computer
vocabulary.txt, voice-words.txtthe voice vocabulary and the send / cancel words
credentials.jsonAPI 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.jksthe signing key of the Android app
FichierContenu
config.tomlla configuration, écrite commentée au premier lancement ; seules les valeurs changent à la sauvegarde (référence)
global.md, sessions.mdles prompts système de la session globale et des sous-sessions (copies écrites une fois, à vous d'éditer)
machine.mdla carte de cet ordinateur
vocabulary.txt, voice-words.txtle vocabulaire de la voix et les mots d'envoi / d'annulation
credentials.jsonclé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.jksla clé de signature de l'application Android

3. Data folderDossier de données

FileFormat and content
state.jsonone 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>.jsonlthe 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.jsonlthe prompts you sent: {time, session, text, images, pastes} per line, newest history_limit (1000) kept
stash.jsonthe stashed prompts, global, with time and session
taxonomy.jsonthe forest of categories and tags: node to parent
usage.jsonlthe ledger of tokens and cost per turn, with the breakdown (input, cache written 5 min / 1 h, cache read, output, thinking)
stats.jsonlactivity events (start, a sign of life each minute, stop, tool, permission decision, limit, error)
prices.json, limits.jsonprices learned from Claude Code; limit state
orchestrator.json, hardware.jsonthe job history (last history); the hardware scan with scan_version
method.jsonwork method detection: counter, the proposal waiting
core.log, debug.logthe core log; the debug trace (only with [debug] enabled)
attachments/<session>/uploaded files, 0600 (Attachments)
rewind/<session>-<time>.jsonwhat a rewind removed (the old leaf, the removed log lines)
plugins/cloned sources and index.json (Settings)
icons/the SVG faces
wake.pythe detector of the wake phrase
FichierFormat et contenu
state.jsonun 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>.jsonlla 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.jsonlles prompts envoyés : {time, session, text, images, pastes} par ligne, les history_limit (1000) derniers gardés
stash.jsonles prompts mis de côté, global, avec l'heure et la session
taxonomy.jsonla forêt de catégories et tags : nœud vers parent
usage.jsonlle 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.jsonprix appris de Claude Code ; état des limites
orchestrator.json, hardware.jsonl'historique des travaux (les history derniers) ; le scan du matériel avec scan_version
method.jsondétection de méthode de travail : compteur, proposition en attente
core.log, debug.logle 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>.jsonce 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.pyle 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.