Skip to content

TUI

The TUI is the default AlphaBase interface.

Terminal window
alphabase

Prompting Patterns

  • Normal message: ask for analysis or implementation.
  • File reference: use @ to attach files from the workspace.
  • Shell shortcut: prefix with ! to run command output inline.
  • Slash commands: prefix with / for built-in flows.

Examples:

@README.md
Explain the project's runtime and workspace behavior.
!git status
/help

Command Palette

Open the command palette with Ctrl+P to quickly access session, model, theme, diagnostics, and runtime actions.

External Editor

Set VISUAL or EDITOR before starting AlphaBase, then use /editor or Open editor in the command palette. A nonempty VISUAL takes precedence over EDITOR.

The setting contains an executable and its arguments. Quoted paths and arguments are supported; shell expansion and pipelines are not executed. Configure graphical editors to wait until editing finishes.

Saving an empty document clears the prompt text only while the original draft is still current. A pending edit does not replace a newer draft or a different conversation. A failed or stale edit can leave a private recovery draft at the reported temporary path. Temporary drafts are not permanent storage.

Exporting A Conversation

Use /export to save a Markdown transcript. The default filename includes the full conversation ID. Existing files, including linked destinations, are not overwritten; choose another filename to export again.

When an editor is configured, the export is saved only after editing succeeds. A failed export reports a private recovery path when a copy is available. Recovery copies are kept in a hidden folder beside the chosen destination; move or remove them once recovered. Saving requires a filesystem that supports hard links; AlphaBase does not fall back to overwriting a destination.

Modes And Agents

  • Switch between primary agents with Tab.
  • The default primary flow is Alpha (alpha-v3).
  • Planning transitions use the restricted plan profile when you want analysis before implementation.

See Agents and Modes.

Session Control

  • Continue previous work with --continue or --session.
  • Fork history when needed with --fork.
  • Export/import session JSON for handoff workflows.

See CLI and Share.