Intégration Claude Code mémoire
Tramya indexe les sessions Claude Code stockées localement dans ~/.claude/projects/, les rattache au dépôt, à la branche et au worktree exact, et prépare la reprise en moins de 5 secondes — dans Claude Code ou dans Codex.
Installation
Récupérez le .dmg macOS signé et notarisé depuis tramya.com. macOS 12+, Apple silicon ou Intel. Les builds Windows et Linux sont en cours de préparation ; en attendant, un lancement via npx tramya reste possible pour tester.
Au premier lancement, Tramya détecte automatiquement ~/.claude/projects/ et démarre l’indexation. Aucun jeton API, aucune configuration : la lecture est locale et déclenchée par l’événement de modification des fichiers JSONL.
Utilisez Claude Code normalement. À la fin de chaque tour, le fichier session-*.jsonl est mis à jour ; Tramya l’ingère en moins d’une seconde et l’associe au dépôt Git courant via git rev-parse --show-toplevel.
Aucune étape ne modifie votre configuration Claude Code. L’intégration est réversible : quittez Tramya et rien ne change pour Claude Code.
Fonctionnement
Claude Code écrit chaque session dans un fichier JSONL ligne par ligne. Tramya lit ces fichiers en streaming — pas de re-parse complet à chaque tour — et extrait quatre couches : messages (rôle, contenu, horodatage), appels d’outils (nom, arguments, sortie tronquée), fichiers touchés (chemins absolus normalisés) et métadonnées (modèle, tokens consommés, raison d’arrêt).
Le rattachement au projet utilise trois signaux, dans l’ordre : le champ cwd de la session, la présence d’un .git parent, et le nom du dossier encodé par Claude Code (les slashes deviennent des tirets dans ~/.claude/projects/-Users-vous-repo/). Les worktrees sont identifiés par git worktree list et indexés séparément — une session sur la branche feature/auth n’est jamais confondue avec la branche main.
Les fichiers CLAUDE.md (global dans ~/.claude/, projet dans le dépôt, sous-dossier) sont lus au moment de la reprise pour reconstruire les règles actives.
Workflow
Cas typique : Claude Code atteint sa limite de tokens en pleine refactorisation, la session se termine avec compact_reached. Ouvrez Tramya, filtrez par dépôt (raccourci ⌘K), cliquez sur la session — vous voyez le dernier message assistant, les 5 derniers fichiers modifiés et les règles projet actives.
Trois actions sont disponibles. Reprendre dans Claude Code lance claude --resume <session-id> dans le bon worktree. Générer un handoff produit un prompt ~600 tokens qui résume l’objectif, les décisions durables et les fichiers en cours ; collez-le dans une nouvelle session ou dans Codex. Exporter la capsule écrit un fichier Markdown dans .tramya/handoffs/ pour partage.
Sur un projet de taille moyenne (150 sessions, 40 Mo de JSONL), la recherche full-text répond en moins de 80 ms grâce à un index SQLite FTS5 local.
Cas d’usage
Tramya sert de pont neutre entre agents. Le format de capsule respecte le contrat MCP prepare_handoff : objectif, décisions taguées durable, dernières commandes shell, fichiers ouverts, règles projet. Ce format est consommé nativement par Codex CLI, Cursor et n’importe quel client MCP configuré avec le serveur tramya.
Trois scénarios fréquents. Bascule modèle : Claude Sonnet a terminé la conception, Codex GPT-5 prend l’implémentation avec le même contexte. Bascule machine : session commencée sur MacBook Pro, poursuivie sur un serveur de build via tramya sync. Bascule collègue : la capsule anonymisée est partagée sur un canal Slack pour reprise asynchrone, sans exposer les jetons ni les diffs sensibles (filtre --redact).
La documentation MCP détaille les outils get_project_context, search_memory et save_memory exposés aux agents.
Dans ~/.claude/projects/ (sessions JSONL) et dans les fichiers CLAUDE.md du dépôt et du profil. Rien ne quitte la machine.
Oui. Tramya la retrouve par dépôt, branche et worktree, et génère une capsule de reprise utilisable dans Claude Code ou Codex.
Non. Lecture seule. Les nouvelles décisions vont dans ~/.claude/projects/<projet>/memory/ via l’outil MCP save_memory.
Oui. Chaque worktree est indexé séparément via son chemin absolu ; la reprise ouvre la bonne branche sans confusion.
Non. Uniquement ce que Claude Code écrit sur disque : messages, outils, fichiers, métadonnées.