# Bast.sh

> Browse SSH hosts, manage keys, and connect from the terminal. The fast way into the servers you use every day. Docs for humans and AI agents. Use `--json` for scriptable CLI output. OpenSSH stays the source of truth.

## Agent resources

- [Agent skill & docs for AI](https://bast.sh/docs/reference/agents): Install for Cursor, Claude Code, and Codex
- [Skill (npx)](https://github.com/ellipse-software/bast/tree/master/skills/bast): `npx skills add ellipse-software/bast -g -y`
- [Skill file](https://bast.sh/bast.skill.md): curl fallback `curl -fsSL https://bast.sh/install-skill | sh`
- [Full docs dump](https://bast.sh/llms-full.txt): All documentation in one file
- [GitHub (bast CLI)](https://github.com/ellipse-software/bast): Source code and releases

## Documentation

- [Introduction](https://bast.sh/docs): What Bast is, how it fits into your SSH workflow, and what you can do with it.
- [Installation](https://bast.sh/docs/install): Install Bast on macOS or Linux via script, Homebrew, or from source.

- **Features**
- Hosts
  - [Host picker](https://bast.sh/docs/features/host-picker): Search, sort, and browse every SSH host Bast finds in your config.
  - [Import from shell history](https://bast.sh/docs/features/history-import): Turn SSH destinations from zsh, bash, and fish history into Bast hosts.
  - [Host management](https://bast.sh/docs/features/host-management): Add, edit, favorite, hide, and organize SSH hosts with groups, tags, and colors.
  - [Advanced host options](https://bast.sh/docs/features/advanced-host-options): Configure jump hosts, startup commands, forwarding, environment variables, and other OpenSSH settings.
  - [SSH config](https://bast.sh/docs/features/ssh-config): How Bast reads, writes, and extends your existing OpenSSH configuration.
  - [Connections](https://bast.sh/docs/features/connections): Connect from the TUI or the shell, with native OpenSSH under the hood.
  - [Files](https://bast.sh/docs/features/files): Browse local and remote files over SFTP, transfer between panes, and open a shell in the current directory.
- Keys
  - [Key management](https://bast.sh/docs/features/keys): Generate, import, export, and install SSH keys from the keys tab or CLI.
  - [Key selector](https://bast.sh/docs/features/key-selector): Pick an identity file, agent defaults, or password auth when setting up a host.
- Sync
  - [Vault](https://bast.sh/docs/features/vault): Sync Bast-managed hosts and keys between machines with end-to-end encryption.
  - [GCP](https://bast.sh/docs/features/gcp): Import Google Cloud VMs into Bast as read-only hosts via the native gcloud CLI.
  - [AWS](https://bast.sh/docs/features/aws): Import Amazon EC2 instances into Bast as read-only hosts via AWS CLI v2.
  - [Azure](https://bast.sh/docs/features/azure): Import Azure Linux VMs into Bast as read-only hosts via the native Azure CLI.
  - [box.ascii.dev](https://bast.sh/docs/features/box): Import ASCII Box sandboxes into Bast as read-only hosts via the native box CLI.
- Other
  - [Command line](https://bast.sh/docs/features/cli): Manage hosts and keys from the shell, with JSON output for scripts and automation.
  - [Keyboard shortcuts](https://bast.sh/docs/features/shortcuts): Every keybinding in the Bast TUI, from navigation to host and key actions.
  - [Mobile layout](https://bast.sh/docs/features/mobile-view): How Bast adapts the TUI for narrow terminals, including phone SSH clients and small windows.

- **Reference**
- [AI agents](https://bast.sh/docs/reference/agents): Install the Bast skill with npx skills (or curl) for Cursor, Claude Code, and Codex, and use llms.txt for agent-friendly docs.
- [Files and storage](https://bast.sh/docs/reference/files): Where Bast writes SSH config, keys, and metadata on your system.
- [Updates](https://bast.sh/docs/reference/updates): How Bast checks for new releases and how to update your install.
- [Telemetry](https://bast.sh/docs/reference/telemetry): What Bast collects, why, and how to opt out.
- [Self-hosting](https://bast.sh/docs/reference/self-hosting): Run your own Bast web app so Vault storage stays on infrastructure you control.