Press ? inside Bast for the in-app reference. Press v for version info, credits, and update hints. A first TUI with no hosts is a skippable start chooser; see First launch.

Key	Action
`↑` / `↓` or `j` / `k`	Move selection
Click / tap list row	Select item (mobile layout)
`1`	Switch to hosts tab
`2`	Switch to keys tab
`3`	Switch to vault tab
`4`	Switch to sync tab
`5`	Switch to files tab
`/`	Search
`r`	Reload config from disk (or refresh sync status on the Sync tab; sync now on Vault)
`?`	Toggle help
`v`	About and version info (`o` replays first-launch chooser, `s` opens https://bast.sh/sponsor)
`D`	Doctor (not in Files; Files uses `D` to disconnect)
`q`	Quit

Hosts

Key	Action
`Enter`	Connect to selected host, or add selected history suggestion
Click / tap Connect	Connect on narrow terminals (mobile layout)
`a`	Add a host
`e`	Edit selected host, or review selected history suggestion
`m`	Move selected local host to a group
`x`	Dismiss selected history suggestion
`d`	Delete selected host
`p`	Promote an external host into Bast-managed config
`f`	Toggle favorite
`F`	Open Files for the selected host
`h`	Hide or show selected host
`.`	Toggle hidden hosts and stopped cloud VMs
`Space`	Collapse or expand group, including Suggested
`s`	Cycle sort mode, or sync the selected provider group
`n`	New VM on a provider group that supports create (Box, Upstash, Vercel)
`o`	Pause/stop a running sandbox or Hetzner host
`r`	Resume a paused sandbox, or start a powered-off Hetzner server (reload config otherwise)
`R`	Restart a running Hetzner Cloud server
`K`	Remove known-host entry

Keys

Key	Action
`g`	Generate a key
`i`	Import a key
`e`	Edit public key comment
`d`	Delete selected key
`a`	Add public key to a server
`x`	Export key files
`p`	Promote an external key, or change passphrase on a managed key
`c`	Copy public key

Vault

Key	Action
`Enter`	Run the selected action (link, unlock, sync, and so on)
Click / tap	Select a menu item; click again to run. The Link / Unlock / Sync chip runs immediately
`r`	Sync now when the vault is unlocked

See Vault.

Sync

Key	Action
`h` / `j` / `k` / `l` or arrows	Move across the provider grid
`Enter`	Open a provider, run the selected action, or connect the selected VM
Click / tap	Select a tile, action, or host; click again to open or run. Status group headers toggle on click
`Space`	Collapse or expand a status group on a provider page
`s`	Sync the focused provider without opening it
`Esc`	Back to the provider grid
`r`	Refresh sync status

See GCP / AWS / Azure / box.ascii.dev / Upstash Box / Vercel Sandbox / Hetzner Cloud for cloud host import.

Files

Key	Action
`Tab`	Switch pane
`w`	Swap panes
`L` / `R`	Make focused pane local / remote
`h` / `l`	Parent / enter directory
`Enter`	Enter directory, preview a file, or connect the selected host
`j` / `k`	Move
`g` / `G`	Top / bottom
`f`	Fuzzy jump
`/`	Path jump (or host search on a remote picker)
`Space`	Toggle mark
`v`	Start or finish range mark
`c` / `m`	Copy / move to the other pane
`d`	Delete (with confirmation)
`a`	Create directory
`r`	Rename
`i`	File info
`o`	Preview file
`p`	Permissions (chmod)
`t`	Open a shell in the current directory
`.`	Toggle hidden files
`D`	Disconnect remote
`Esc`	Clear marks, else disconnect, else return to Hosts
`Esc` / `x`	Cancel transfer or connect

Click a pane to focus it, a row to select it, and the same row again to enter or connect. Scroll wheel moves the pane under the pointer.

See Files for transfer and auth notes.

During SSH

Action	Result
`exit`	Close SSH session and quit Bast
`Enter` then `~.`	Force-close a stuck SSH session and return to the picker

Keyboard shortcuts

Navigation