TUI
The TUI is the default AlphaBase interface.
alphabasePrompting 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.mdExplain the project's runtime and workspace behavior.!git status/helpCommand 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
planprofile when you want analysis before implementation.
Session Control
- Continue previous work with
--continueor--session. - Fork history when needed with
--fork. - Export/import session JSON for handoff workflows.