[!IMPORTANT]
Alethe is an early public release. The desktop app is free, open source, and local-first, not
local-only: update checks and provider usage polling are on by default, while other network features
are optional or action-triggered. Manual GitHub Gist Sync is already available; first-party hosted
sync or cloud backup may be offered separately later. See the
privacy and data-flow guide.
https://github.com/user-attachments/assets/e5e52485-51e8-476c-acf3-4a5a5400dacf
What Alethe Is
One agent in one terminal is easy. Five agents across three repositories is the actual job — and
that is where terminal tabs stop working: sessions get lost, MCP servers drift out of sync between
agents, and nobody knows which agent is doing what, where.
Alethe is a desktop workspace built for that. Every agent runs in a real PTY inside a persistent
project layout, keeps its own session and history, and stays alive when you rearrange the UI. On top
of that, Alethe manages the things agents share: their CLIs, their MCP servers, their skills, and the
conversations you move between them.
Cross-platform (Windows, macOS, Linux), local-first, built with Tauri, Rust, React, and xterm.js.
“Local-first” describes workspace persistence, not an internet-free guarantee; see
docs/PRIVACY.md for current network defaults, credentials, and retention.
Supported Platforms
Agents
| Agent | CLI | |
|---|
| Claude Code | claude | Session resume, usage cards, local history |
| Codex | codex | Session resume, usage cards |
| GitHub Copilot CLI | copilot | |
| Cursor | cursor-agent | Session resume |
| Antigravity | agy | Usage cards |
| OpenCode | opencode | Session resume |
| Kiro CLI | kiro-cli | |
| Kimi Code | kimi | |
| Grok Build | grok | |
| Codewhale | codewhale | |
| Mimo | mimo | |
| Freebuff | freebuff | |
| Shell | pwsh / bash / zsh | The plain terminal, same pane model |
| WSL | wsl.exe | The default distro, as a plain shell (Windows) |
Missing CLIs can be installed, updated, and uninstalled from inside Alethe — it probes the machine
for Node, npm, WinGet, Scoop, and Chocolatey and offers only the methods that actually work there,
preferring each vendor's official installer. Already-installed CLIs are discovered across PATH,
registry, npm/pnpm/Volta/fnm/nvm/Bun/Cargo/Scoop/Chocolatey, and can be pointed at a custom path.
A plugin can add an agent of its own to this list.
Agents can optionally be routed through 9router, a local proxy
that spreads traffic across providers with automatic fallback. Alethe installs and runs a private,
version-pinned copy without touching your global npm packages. Routing is off by default and applies
only to terminals opened after it is switched on.
What It Does
Run agents in parallel
- Projects, groups, and subgroups organize repositories; each open project becomes a container with
its own panes.
- One agent per pane, or several agents as sub-tabs inside the same pane — each with its own PTY,
working directory, and session.
- Auto, spotlight, sidebar, and custom grid layouts, editable directly on the grid.
- Closing a container hides it; the process keeps running.
Keep the context
- Sessions of Claude Code, Codex, Cursor, and OpenCode resume after a crash or a restart.
- Recent chats lists the conversations of a pane's working directory and reopens any of them.
- A Claude Code conversation can be handed off to Codex (and back) through a locally redacted
context packet — no copy-pasting the thread by hand. Redaction is best effort, so review the packet
before starting the target agent.
- Scrollback is persisted per PTY, so reattaching shows what happened before.
Manage what the agents share
This is the beginning of the README. Read the rest at the original. Read the full README ↗
