Tramya documentation

Install, connect, resume.

The official hub to install Tramya, connect your AI agents, and resume a conversation across Claude Code, Codex, and Gemini CLI.

Install the Tramya app

Download, install, and open. No terminal, Node.js, or npm required.

Tramya for macOSApple Silicon, standalone DMG Tramya for WindowsWindows 10/11 x64, installer

The Tramya documentation covers three desktop platforms: macOS 12 and later on Apple Silicon, Windows 10 and 11 on x64, and Linux via npx. The macOS DMG weighs 118 MB and bundles the local engine, the SQLite database, and connectors for all ten supported agents. On macOS, the first launch goes through Gatekeeper: right-click Tramya, then Open, or double-click the included Ouvrir Tramya.command file shipped since version 1.1.28. On Windows, SmartScreen shows a warning: click More info, then Run anyway. Installation completes in under 60 seconds. Updates are then handled by Sparkle on macOS and by the Windows installer, with progress shown as a percentage and in megabytes in Settings since version 1.1.27.

First launch and getting started

The app starts its local engine and opens your Tramya workspace in a single step.

What Tramya does on first launch
  1. Starts the bundled local engine on port 47821.
  2. Scans the known agent directories (~/.claude, ~/.codex, ~/.gemini) to locate their histories.
  3. Sets up automatic launch at login, with no administrator password.
  4. Opens your Tramya workspace to pair your Free account.

Getting started takes about two minutes. Create a Free account from the pairing window, choose the root folder for your projects, and Tramya automatically indexes your existing conversations. Since version 1.1.25, the dashboard cold-start is seven times faster on workspaces with more than 500 conversations. The full diagnostics remain available from the Tramya menu, under Help, then Diagnostics. Uninstalling never deletes your local data: your histories stay in ~/Library/Application Support/Tramya on macOS and %APPDATA%/Tramya on Windows.

Connect your AI agents

Diagnostics detects the apps already installed and reads their histories.

Claude CodeCodexGemini CLIHermesGitHub CopilotCursorClineOpenCodeRoo CodeAider

Tramya supports ten AI agents through local reads: Claude Code, Codex, Gemini CLI, Hermes, GitHub Copilot, Cursor, Cline, OpenCode, Roo Code, and Aider. No connection to your AI accounts is ever requested. Tramya only reads the history files these agents have already written to your disk, typically in JSON or JSONL format. The Free plan includes Claude Code, Codex, and Gemini CLI. The Pro plan unlocks the remaining seven connectors plus multi-account sync. To add an agent manually, open Settings, Sources, then point to the folder containing the histories. Detailed per-agent guides are available at /integrations, with the list of indexed fields and a refresh frequency configurable between 30 seconds and 10 minutes.

Capture a web chat

The browser extension saves only the conversation you choose.

Open SettingsGrab the extension folder.
Add the extensionLoad it into Chrome, Edge, Brave, or Arc.
PairCopy the local token shown.

The Tramya browser extension covers ChatGPT, Claude.ai, Gemini, Perplexity, Mistral Le Chat, and Poe. It works declaratively: nothing is sent to the local engine until you click Save to Tramya from the conversation sidebar. The pairing token is a 128-bit local secret generated at install time, revocable from Settings, Devices. Communication runs over secure WebSocket on localhost:47821, never leaving your machine. The extension weighs 340 KB and updates automatically through the Chrome Web Store. For Firefox, a signed build is available as a direct download from /download/firefox-extension.

Resume a thread across agents

Open a conversation and choose the agent to continue in.

Cross-agent handoff is Tramya's core feature. Two modes exist depending on the target agent. Native mode uses the agent's built-in resume API: available for Claude Code (via --resume), Codex (via session-id), and Gemini CLI (via --continue). Capsule mode generates a compact context of about 4,000 tokens containing the active project, the relevant CLAUDE.md or AGENTS.md rules, the pinned memories, and the last 15 meaningful messages. The context is copied to the clipboard and injected automatically into the target agent. Compression relies on a local semantic summary, with no network calls. See the handoff guide for customizable capsule templates and tag-based filtering rules.

Account, Mobile, and Cloud

A Free account unlocks the download. Your conversations stay local by default.

FreeClaude Code, Codex, and Gemini CLI, local search, unlimited projects, and one device.
ProAll connectors, multi-account, resume and handoff, MCP/skills kit, local backups, remote control, and three devices.
CloudEverything in Pro, plus an encrypted vault, sync, remote restore, offline access, and unlimited devices.

Keep your recovery key safe. Tramya cannot reconstruct it.