OpenTheia

Rust desktop workspace for terminal-native coding agents

Run your agent stack like a real workspace.

OpenTheia keeps your coding tools organized in grouped tabs, restores durable sessions when it can, and gives you a clean GUI or TUI without leaning on tmux.

  • GUI + TUI modes
  • Session-aware restarts
  • Hotkeys, pinning, dumps
workspace: andy
[pin] opentheia [live] pagesnag terminal 1

wizard workspace loaded from agent_workspace.json

launch Hermes Agent resumed in tab 1

status saved durable session for opentheia

action Ctrl+N duplicated the active tab template

dump context export ready for handoff

input keeping every tool in the same place

30+ tool presets in the workspace wizard
2 interfaces: native GUI and legacy TUI
0 tmux or wrapper dependencies required
1 config file to restore your working setup

What makes it useful

Designed for people juggling multiple agent sessions at once.

Grouped workspaces

Keep coding tools arranged by project or role, then cycle through groups and tabs with simple keyboard shortcuts.

Session capture and resume

OpenTheia stores live session ids for tools like Hermes so restarts can reconnect to the same conversation instead of starting over.

Fast operator controls

Pin hot tabs, rename them in place, send macro commands on F1-F4, and export scrollback when you need a clean handoff.

Local-first desktop feel

The app launches native PTYs directly, stores config on disk, and even includes desktop integration for launcher and dock workflows.

Workflow

From setup to steady-state in three moves.

01

Shape the workspace

Run the wizard, name the project, create groups, choose tools, and save everything into a single JSON workspace file.

02

Launch and reconnect

Start the GUI or TUI, let each tab boot its own PTY, and resume durable sessions where the underlying tool supports it.

03

Stay in flow

Switch tabs, send macros, pin the important work, and dump context when it is time to checkpoint or hand the thread to someone else.

Compatibility

Preset mappings for popular coding CLIs and orchestrators.

Install

Clone it, run the wizard, and open the workspace.

Quick start

git clone https://github.com/mediafill/opentheia.git
cd opentheia
cargo run -- --wizard
cargo run -- --gui

Desktop integration

./install-desktop-integration.sh

Installs the desktop entry, icon, and dock pinning hooks for local Linux desktop workflows.