Skip to content
AlphaBase
HomeDocs

Migration Notes

Historical notes for the AlphaBase 1.0 TUI migration.

This page records the historical 1.0-era TUI migration. It is not a current release or installation promise.

The migration replaced the older Go/Bubble Tea interface with the OpenTUI-based interface used by the current source tree.

The TUI still uses the shared AlphaBase runtime/server contract, but exact UI behavior depends on the client and checkout you are running.

Upgrading

Use the upgrade command only with a version that is actually published by the installation channel you use:

Terminal window
alphabase upgrade <published-version>

The repository does not guarantee a public release artifact or a particular version numbering scheme. For the currently verified path, run AlphaBase from the source checkout described in Setup CLI.

UX changes

The session history is more compressed, only showing full details of the edit and bash tool.

We added a command bar which almost everything flows through. Press ctrl+p to bring it up in any context and see everything you can do.

Added a session sidebar (can be toggled) with useful information.

We removed some functionality that we weren’t sure anyone actually used. If something important is missing please open an issue and we’ll add it back quickly.

Breaking changes

Keybinds renamed

  • messages_revert -> messages_undo
  • switch_agent -> agent_cycle
  • switch_agent_reverse -> agent_cycle_reverse
  • switch_mode -> agent_cycle
  • switch_mode_reverse -> agent_cycle_reverse

Keybinds removed

  • messages_layout_toggle
  • file_diff_toggle
  • file_search
  • file_close
  • file_list
  • app_help
  • project_init
  • thinking_blocks

messages_next, messages_previous, and tool_details were also removed at 1.0 but have since been reinstated (see Keybinds) — they are real, working keybinds again as of the current version.