Faut-il installer Node.js ou npm pour utiliser Tramya ?

Non. Le DMG macOS contient le moteur local et reste l installation recommandée. Aucune commande terminal n est requise pour l usage standard. La commande npx @tramya/installer install est réservée aux serveurs, au Runner headless, à Linux et aux workflows d automatisation.

Comment reprendre une conversation dans un autre agent ?

Ouvrez la conversation dans Tramya, cliquez Reprendre, choisissez l agent cible. Tramya utilise la reprise native si l agent la supporte (Claude Code, Codex), sinon il génère un contexte compact avec projet, règles, mémoires et messages clés.

Mes conversations sont-elles envoyées sur les serveurs Tramya ?

Non par défaut. Le plan Free et le plan Pro stockent toutes les conversations en local. Seul le plan Cloud (optionnel) synchronise via un coffre chiffré côté client avec clé de récupération non reconstituable par Tramya.

Que faire si macOS refuse d ouvrir Tramya au premier lancement ?

Faites clic droit sur l icône Tramya puis Ouvrir. macOS affiche une seconde fenêtre avec un bouton Ouvrir explicite. Depuis la version 1.1.28, un fichier .command double-cliquable autorise Gatekeeper en une étape.

Documentation Tramya

Installer, connecter, reprendre.

Q: Quels agents IA Tramya détecte-t-il automatiquement ?

Tramya lit les historiques locaux de dix agents : Claude Code, Codex, Gemini CLI, Hermes, GitHub Copilot, Cursor, Cline, OpenCode, Roo Code et Aider. Aucun jeton d API n est demandé, Tramya lit uniquement les fichiers déjà présents sur le disque.

Le hub officiel pour installer Tramya, connecter vos agents IA et reprendre une conversation entre Claude Code, Codex et Gemini CLI.

Ouvrir dans ChatGPT Ouvrir dans Claude Ouvrir dans Perplexity

Tramya embarque un serveur MCP local, lancé par le compagnon sur 127.0.0.1:4317. Vous n avez aucune commande MCP à taper : l application écrit la configuration pour vous, puis vos agents appellent get_project_context, search_memory, save_memory et request_secret_use.

1. Installer Tramya

Le DMG macOS ou l installateur Windows suffisent. Pour Linux ou un poste headless, la ligne de commande officielle :

npx @tramya/installer install

2. Réglages → « Installer dans mes agents »

Depuis le tableau de bord Tramya, ce bouton enregistre automatiquement le serveur MCP dans la configuration de Claude Code, Cursor et Codex, sans copier de commande ni de chemin manuel. Relancez ensuite l agent et vérifiez la connexion via sa commande de diagnostic (/mcp dans Claude Code).

Installer l application Tramya

Téléchargez, installez et ouvrez. Aucun terminal, Node.js ou npm n est nécessaire.

Tramya pour macOSApple Silicon, DMG autonome Tramya pour WindowsWindows 10/11 x64, installateur

La documentation Tramya couvre trois plateformes de bureau : macOS 12 et supérieur sur Apple Silicon, Windows 10 et 11 en x64, et Linux via npx. Le DMG macOS pèse 118 Mo et embarque le moteur local, la base SQLite et les connecteurs des dix agents supportés. Sur macOS, le premier lancement passe par Gatekeeper : faites clic droit sur Tramya, puis Ouvrir, ou double-cliquez le fichier Ouvrir Tramya.command inclus depuis la version 1.1.28. Sous Windows, SmartScreen affiche un avertissement : cliquez Informations complémentaires, puis Exécuter quand même. L installation est terminée en moins de 60 secondes. La mise à jour est ensuite gérée par Sparkle sur macOS et par l installateur Windows, avec progression visible en pourcentage et en mégaoctets dans Réglages depuis la version 1.1.27.

Serveurs, Runner headless et Linux · mode avancé

npx @tramya/installer install

Créer un compte Free

Premier lancement et get started

L application démarre son moteur local et ouvre votre espace Tramya en une étape.

Ce que fait Tramya au premier démarrage

Démarre le moteur local inclus sur le port 4317.
Scanne les répertoires connus des agents (~/.claude, ~/.codex, ~/.gemini) pour retrouver les historiques.
Configure le lancement automatique à l ouverture de session, sans mot de passe administrateur.
Ouvre votre espace Tramya pour l appairage du compte Free.

Le get started prend environ deux minutes. Créez un compte Free depuis la fenêtre d appairage, choisissez le dossier racine de vos projets et Tramya indexe automatiquement les conversations existantes. Depuis la version 1.1.25, le cold-start du dashboard est sept fois plus rapide sur les workspaces contenant plus de 500 conversations. Le diagnostic complet reste accessible via le menu Tramya, rubrique Aide, puis Diagnostic. La désinstallation ne supprime jamais vos données locales : les historiques restent dans ~/Library/Application Support/Tramya sur macOS et %APPDATA%/Tramya sous Windows.

Connecter vos agents IA

Le diagnostic repère les applications déjà installées et lit leurs historiques.

Claude CodeCodexGemini CLIHermesGitHub CopilotCursorClineOpenCodeRoo CodeAider

Tramya prend en charge dix agents IA en lecture locale : Claude Code, Codex, Gemini CLI, Hermes, GitHub Copilot, Cursor, Cline, OpenCode, Roo Code et Aider. Aucune connexion à vos comptes IA n est demandée. Tramya lit uniquement les fichiers historiques déjà écrits par ces agents sur votre disque, généralement au format JSON ou JSONL. Le plan Free inclut Claude Code, Codex et Gemini CLI. Local Lifetime débloque les sept connecteurs restants et le multi-compte sur un ordinateur. Pour ajouter un agent manuellement, ouvrez Réglages, Sources, puis pointez vers le dossier contenant les historiques. Les guides détaillés par agent sont disponibles sur /integrations, avec la liste des champs indexés et la fréquence de rafraîchissement configurable entre 30 secondes et 10 minutes.

Capturer une discussion web

L extension navigateur enregistre uniquement la conversation que vous choisissez.

Ouvrir RéglagesRécupérez le dossier de l extension.

Ajouter l extensionChargez-la dans Chrome, Edge, Brave ou Arc.

AppairerCopiez le jeton local affiché.

L extension navigateur Tramya couvre ChatGPT, Claude.ai, Gemini, Perplexity, Mistral Le Chat et Poe. Elle fonctionne en mode déclaratif : rien n est envoyé au moteur local tant que vous ne cliquez pas sur Sauver dans Tramya depuis la sidebar de la conversation. Le jeton d appairage est un secret local à 128 bits généré à l installation, révocable depuis Réglages, Appareils. La communication passe par WebSocket sécurisé sur localhost:4317, sans jamais quitter la machine. L extension pèse 340 Ko et se met à jour automatiquement via le Chrome Web Store. La distribution Firefox n’est pas encore proposée.

Reprendre un fil entre agents

Ouvrez une conversation et choisissez l agent dans lequel continuer.

La reprise entre agents est la fonction cœur de Tramya. Deux modes existent selon l agent cible. Le mode natif utilise l API de reprise interne de l agent : disponible pour Claude Code (via --resume), Codex (via session-id) et Gemini CLI (via --continue). Le mode capsule génère un contexte compact d environ 4000 tokens contenant le projet actif, les règles CLAUDE.md ou AGENTS.md pertinentes, les mémoires épinglées et les 15 derniers messages significatifs. Le contexte est copié dans le presse-papier et injecté automatiquement dans l agent cible. La compression utilise un résumé sémantique local, sans appel réseau. Consultez le guide de handoff Claude Code vers Codex pour préparer une capsule de continuité.

Donner des secrets à vos agents avec `tramya run`

Vos agents utilisent vos clés d’API sans jamais les voir.

Le Coffre Tramya stocke vos secrets chiffrés en local (AES-256-GCM). Au lieu de coller une clé en clair dans un .env que l’agent peut lire, vous y mettez une référence ; la vraie valeur ne quitte jamais le coffre :

OPENAI_API_KEY=tramya://local/OpenAI/api-key

Cette référence est sans danger à committer. Quand une commande a besoin du secret, tramya run demande votre approbation dans le Coffre, injecte la vraie valeur dans le sous-processus et la masque dans la sortie. L’agent obtient un processus qui marche, jamais la clé.

Prérequis : l’application Tramya lancée (le compagnon écoute sur 127.0.0.1:4317), le coffre déverrouillé, et la double authentification activée dans le Coffre (l’approbation exige une vérification renforcée). Installez la commande avec npm i -g @tramya/installer.

Référencez ensuite vos secrets dans un .env, puis lancez votre commande à travers Tramya :

tramya run --env-file .env -- npm run deploy

Une fenêtre d’approbation s’ouvre dans le Coffre : vous voyez quelle commande demande quels secrets. Après validation, la commande s’exécute avec les valeurs injectées, masquées partout où le modèle pourrait les lire. Une fenêtre de cinq minutes évite de ré-approuver à chaque commande.

Compte, Mobile et Cloud

Un compte Free donne accès au téléchargement. Vos conversations restent locales par défaut.

FreeClaude Code, Codex et Gemini CLI, recherche locale, projets illimités et un appareil.

Local LifetimeTous les connecteurs, multi-compte, reprise et handoff, kit MCP/skills et sauvegardes locales sur un ordinateur.

ProTout Local Lifetime, plus Missions, Pilotage des agents, Design Hub, Équipes, contrôle distant et jusqu’à trois appareils.

CloudTout Pro, plus coffre chiffré, synchronisation, restauration distante, consultation hors ligne et appareils illimités.

Conservez votre clé de récupération. Tramya ne peut pas la reconstituer.

Comment les briques Tramya marchent ensemble

Le vocabulaire minimal pour situer chaque pièce avant de brancher un agent.

Serveur MCP: Le pont local qui laisse un agent (Claude Code, Cursor, Codex) lire et écrire le contexte de projet via le Model Context Protocol, sans jeton ni appel réseau.
Tramya Vault: Le coffre local chiffré où vivent mémoires, décisions et secrets ; rien n en sort tant que vous n activez pas la synchronisation Cloud.
Passport de projet: La fiche condensée d un projet (pile technique, conventions, décisions durables) que l agent récupère en un appel pour reprendre le fil.
Worktree: Une copie de travail Git isolée : Tramya indexe l historique par dépôt, branche et worktree pour ne jamais mélanger les contextes.
request_secret_use: L outil MCP par lequel un agent demande à utiliser un secret du coffre ; vous approuvez localement et l agent obtient le résultat sans jamais voir la valeur.
Coffre cloud: La synchronisation chiffrée côté appareil, optionnelle et activable par projet, qui réplique le coffre entre vos postes avec une clé de récupération que Tramya ne peut pas reconstituer.