Skip to content
tmux-ide

App surfaces

Home, Terminals, contextual commands, and optional project views

Home

Home is the configless front door. It shows live tmux session count, aggregate agent status, the selected session, theme control, and the action to open Terminals. It intentionally has no persistent workspace sidebar.

When no tmux server exists, Home stays useful and offers a new-session action. The session list updates as ordinary tmux sessions appear or disappear.

Terminals

Terminals is a visual client for the selected tmux session:

  • the left sidebar lists the current session and detected agents;
  • the window strip reflects real tmux windows and creates new ones;
  • every pane has a title, state, and relevant controls;
  • terminal content is mirrored as terminal cells, including indexed and truecolor output;
  • pane clicks and agent rows navigate to the canonical tmux pane;
  • splitting, resizing, renaming, creation, and closing are daemon-owned tmux mutations, not a parallel layout model.

The UI retains terminal content through quiet periods, resize, theme switching, daemon replacement, and viewer reattachment. tmux remains the source of truth.

Commands and notifications

F5 or Ctrl+P opens the command surface. Transient action notes, such as a successful split, dismiss automatically and do not become permanent chrome.

Project-defined views

WorkspaceConfigV1 can order full-panel views for home, terminals, files, diff, and missions, or compose them with split and tab layouts. Files, changes, dialogs, settings, palettes, and rich previews are loaded as optional features so the resident terminal path stays small.

The Missions panel is presentational in this beta. harnesses, agents, and missions workspace blocks are validated, but there is no public CLI command that dispatches those mission defaults yet. tmux-ide web is also explicitly unavailable; the daemon remains renderer-neutral for future clients.