Skip to content

Migration Notes

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

Exact UI behavior depends on the installed version. Consult the current TUI guide when upgrading.


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. Follow Setup CLI for the approved distribution path.


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.