Desktop app
The Empryo desktop app: a native multi-tab client with the living Genome map, Monaco preview, visual diffs, embedded terminals, and drawer-based controls.
The desktop app is a native client for the same engine the TUI and headless CLI run. It adds a windowed, multi-pane workspace: a living map of your codebase, a real editor preview, visual diffs, embedded terminals, and every setting behind a drawer. macOS, Windows, and Linux (.AppImage/.deb/.rpm). Grab it from the download page.
How it's built
The app is Electron. The window you see is a React renderer; the agent itself runs in a bundled background process (the "bridge") that talks to the renderer over a small JSON-line protocol. That bridge builds the exact same agent the terminal uses — one code graph and one memory store per window — so behavior is identical across surfaces. Settings are shared with the CLI by default, so your keys, theme, and config carry over.
Tabs
Each tab is an independent conversation lane on one shared workspace, mirroring the TUI. Tabs share the Genome and memory and coordinate edits through cross-tab file claims; every edit is attributed to its tab.
| Shortcut | Action |
|---|---|
Cmd/Ctrl+T | New tab |
Cmd/Ctrl+W | Close tab |
Cmd/Ctrl+1…9 | Switch tab |
Cmd/Ctrl+K | Command palette |
Each tab chip shows its index, a running indicator, the model, the count of files edited, and the running cost. Double-click to rename, drag to reorder.
The Primordial Deep
The signature desktop surface is a living map of your repository's context window. Every file is a cell drifting in space; the agent is a micro-organism that swims to whatever file it is touching right now. The layout comes from your real dependency graph and PageRank — structure never moves, so the map stays stable as the agent works.
Files move through awareness tiers as the session runs:
- Unknown — fog, never looked at.
- Known — present in the injected Genome.
- Discovered — read or touched this session (the fog lifts with a pulse).
- Edited — changed by the agent.
A scoreboard tracks coverage, links, and edits, with achievement badges and milestone toasts as coverage climbs. Hover any cell for its imports, importers, blast radius, and co-changes; fuzzy-search to fly the camera to a file. Open it fullscreen or dock it beside the chat.
Panes
- Sidebar — a virtualized file tree with a filter; edited files get a diff button.
- Context pane — Context, Memory, and Errors tabs: genome token stats, recently read and edited files, top memories, loaded skills, and live indexing status.
- Inspector — a live tool-call log with elapsed timers, and a visual before/after diff viewer.
- Status bar — genome counts, token and cost totals, files edited, git branch, and a cross-tab file-claims popover.
- File preview — a Monaco editor with real go-to-definition, find-references, and hover, backed by the language servers. Edit and save with
Cmd/Ctrl+S.
Drawers
Every control lives in a drawer, opened from the titlebar or the command palette:
Theme, window (opacity, blur, vibrancy, density, motion), intelligence depth, add-ons, and general options.
Provider API keys plus a Codex (ChatGPT) sign-in card.
Add and edit project or global MCP servers with live status.
Search, install, load, and remove skills.
Install, update, and restart language servers from the Mason registry.
Stage, unstage, and commit, with click-to-preview diffs.
Per-slot task-router models and the max concurrent agents.
Disk usage by category, with per-category clear and database vacuum.
Hooks, the tool enable/disable catalog, and privacy globs.
Health and setup checks — prerequisites, Nerd Fonts, and diagnostics.
Remote control over Telegram or Discord — pairing, daemon, and logs.
The CLIProxyAPI relay lifecycle with a live login console.
Desktop-only features
These exist only in the desktop app:
- The Primordial Deep — the live WebGL Genome map.
- Monaco preview — an editable buffer with real code intelligence.
- Visual diffs — virtualized before/after line diffs in the inspector and sidebar.
- Embedded terminals — up to five real shells (a VS Code-style shell picker), toggled with `
Ctrl+``. - Image pipeline — attach, paste, or drag in images; crop and annotate them inline; open them in a lightbox. They flow to the agent as vision parts.
- Streaming OAuth consoles for the proxy and subscription sign-ins.