Wakterm

Features

wakterm Focus#

wakterm keeps the core WezTerm terminal foundation, with extra focus on multiplexer reliability, persistent layouts, and agent-driven workflows.

  • Persistent layouts: auto-save and restore tabs, split trees, working directories, titles, and active-tab selection across mux server restarts and reboot
  • Manual layout snapshots via wakterm cli save-layout and wakterm cli restore-layout
  • Pane-local shell history that survives mux restarts, with shell integration loaded automatically into bash, zsh, fish, and Wsh
  • First-class agent harness panes for Agy, Claude, Codex, Devin, Gemini, Muse, OpenCode, and ZCode
  • Automatic agent detection and cached session adoption
  • Exact-session restoration for Agy, Claude, Codex, Devin, Muse, and ZCode across mux restarts and system reboot
  • Supervised Codex app-server TUI via wakterm agent launch codex
  • Measured idle overhead: 34.44 MiB PSS to restore and hold 20 workspace tabs and 7 shell splits, with 0.0016% of one core
  • Shared Codex app-server benchmark: 46.4% less PSS and 89.2% less idle CPU across 20 Codex TUIs
  • Versioned Agent API v1 with capability negotiation, catalog, caller resolution, authoritative prompt admission, approval and question-form resolution, and durable event streams
  • Idle agent freezing on Linux and Windows to swap out inactive Claude sessions, paired with mux-delivered agent reminders (wakterm agent remind)
  • Hidden tabs and dedicated tab navigator (Alt-E or Ctrl-Shift-E / Cmd-E, Ctrl-Shift-S / Cmd-Shift-S, and Ctrl-H in the navigator)
  • Live activity-order tab sorting (Ctrl-Shift-B), shrinking overflowing tab titles down to their harness icon, and Alt-1..9 tab switching
  • Attention queue navigation with ActivateNextTabNeedingAttention, newest first and skipping hidden tabs, and ActivateOldestTabNeedingAttention from the queue's other end
  • Agent attention indicators with subtle icon pulse, working-tab activity marker, optional dimming of working or already-reviewed agent tabs, and shared turn review acknowledgement across clients
  • Automatic tab naming from active agent directories with collision disambiguation
  • Native harness icons and generated per-tab background colors in the tab bar
  • Live agent progress with wakterm agent watch and wakterm agent list -f
  • Prompt submission and interrupt flows that keep the real harness UI in the pane, set aside idle Claude drafts, and refuse to type over active user input
  • Multi-client multiplexer synchronization with server authority, explicit resize origin tracking, and reconnect tab order reconciliation
  • Reliable split and spawn sizing so panes agree on the same layout across clients
  • User-set tab titles are preserved instead of being overwritten by terminal escape sequences

Core Terminal Features#

Edit this page