Skip to content

v0.0.3

Choose a tag to compare

View all tags
@github-actions github-actions released this 10 Jun 11:55
v0.0.3
5e5f9d3

AgentMux v0.0.3

Control TUI usability, terminal fidelity, and resize smoothness release.

Highlights

  • Added Control device login support so agentmux control login and agentmux-tui can obtain and cache Control credentials without manually passing tokens.
  • Improved the Control TUI session workflow:
    • smoother session list navigation
    • in-TUI login prompts
    • attach opens in the right-side terminal area by default
    • Ctrl-F toggles full-screen attach
    • Ctrl-] detaches, Ctrl-Q exits, and Ctrl-G writes debug snapshots when debug mode is enabled
  • Added detailed TUI observability with --debug, --debug-log, render counters, stream queue state, terminal view size tracking, and manual debug snapshots.
  • Added a terminal emulator backed TUI attach path that can render live remote terminal output, preserve stream buffers across detach/re-attach, and avoid the previous "waiting for terminal output" dead state.
  • Added UTF-8 input handling for attached sessions, including Chinese input.
  • Added mouse support foundations in the TUI:
    • local session selection by mouse
    • local split boundary dragging
    • remote mouse event forwarding when the attached terminal enables mouse mode
    • SGR mouse sequence support for remote tmux interactions such as pane focus and pane border dragging
  • Improved tmux pane preview composition so Worker previews can include the visible multi-pane tmux window instead of only the active pane.
  • Smoothed attach resize behavior:
    • local split dragging no longer continuously sends remote resize requests
    • remote resize is debounced after mouse release
    • tmux redraw output after resize is settled before the Control TUI repaints
    • Control-side repaint frequency is lowered to reduce flicker and intermediate redraw frames
  • Fixed Unicode terminal width handling for box drawing characters such as ─, │, ├, ┤, and ┼, preventing split-pane borders from being truncated in the TUI.
  • Added a built-in PTY session backend fallback for Workers when tmux is not available. tmux remains preferred for durable sessions across Worker restarts.
  • Improved Web Control workspace behavior:
    • persistent workspace tabs and split layouts
    • drag-and-drop session placement across panes
    • open-in-new-tab and detach controls for active sessions
    • per-worker tmux prefix settings with legacy setting migration
    • recent working-directory suggestions when creating sessions
  • Changed session creation to wait for Worker confirmation. The Hub now returns 201 Created only after the Worker accepts the session, and Worker-side validation failures are surfaced as 400 Bad Request.

TUI Control

The dedicated TUI entrypoint remains:

agentmux-tui

First-time Control onboarding can use a generated join signal:

agentmux-tui join --hub https://hub.example.com --join 'amx_sig_...'

Or the browser/device login flow:

agentmux control login --hub https://hub.example.com
agentmux-tui

Inside the TUI:

  • Enter or a: attach the selected session in the right-side terminal area
  • Ctrl-F: toggle full-screen attach
  • Ctrl-]: detach from the active attached session
  • Ctrl-Q: quit the TUI
  • /fullscreen: attach and enter full-screen from the command prompt
  • mouse click: select a session or focus the attached terminal area
  • mouse drag: adjust the local session list / terminal split

When the remote terminal enables mouse mode, TUI mouse events are forwarded to the remote terminal. This allows tmux-native mouse behavior such as pane focus and pane resizing from the Control TUI.

Debugging

TUI debug mode can be enabled with:

agentmux-tui --debug --debug-log /tmp/agentmux-tui-debug.log

or:

agentmux control app --hub https://hub.example.com --debug --debug-log /tmp/agentmux-tui-debug.log

Debug snapshots record render counts, stream event counts, pending queue sizes, selected session metadata, active stream state, terminal view sizes, and recent resize state. They intentionally avoid including credentials or terminal output.

Worker Backend

Worker backend selection now supports:

agentmux worker config --backend auto
agentmux worker config --backend tmux
agentmux worker config --backend pty

auto uses tmux when available and falls back to the built-in PTY backend otherwise.

The PTY backend supports detach and re-attach while the Worker process is alive. It is not durable across Worker process restarts, so tmux is still recommended for long-running agent sessions that must survive Worker restarts.

Auth And Credential Refinements

  • Control credentials can be exchanged, cached, and refreshed through the same credential cache used by the TUI and CLI.
  • Worker credential handling was refined so background services and foreground runs can reuse saved Worker identity more consistently.
  • Web auth and signal exchange paths were tightened for Control device login and generated Control URLs.

API And Web Control

  • POST /api/sessions now returns {"status":"created"} after the Worker confirms session creation.
  • Worker session creation failures such as invalid working directories are returned directly to the Control client instead of being hidden behind an asynchronous queued state.
  • Web Control keeps workspace layout state in the browser so reconnecting or switching views does not discard pane placement.
  • Web Control terminal panes include tmux prefix controls for tmux-backed sessions.

Fixes

  • Fixed TUI attach hangs caused by missing local stream observability and output warmup handling.
  • Fixed TUI attach defaulting to full-screen mode; attached sessions now open in the right-side area by default.
  • Fixed TUI Chinese input and UTF-8 forwarding in attached sessions.
  • Fixed remote tmux mouse forwarding from TUI attach sessions.
  • Fixed excessive remote resize churn during local split dragging.
  • Fixed repeated intermediate Control TUI repaints during remote tmux resize redraws.
  • Fixed box drawing truncation caused by byte-counting Unicode terminal characters.
  • Fixed the Web Control TypeScript release build by restoring the terminal settings reader and required icon import in the published tag.

Compatibility Notes

  • Existing explicit token workflows remain supported:
agentmux control app --hub https://hub.example.com --token amx_cred_...
agentmux worker run --hub https://hub.example.com --token amx_cred_...
  • Existing Web Control flows continue to work.
  • TUI mouse forwarding depends on the remote application enabling mouse reporting. tmux users should enable mouse support in tmux when they want pane selection and border dragging from the TUI.
  • Windows release assets are still not published because Worker and terminal attach paths currently rely on Unix PTY behavior.
Assets 10
Loading