# 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 file](https://bast.sh/bast.skill.md): `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.

- **Features**
- [Host picker](https://bast.sh/docs/features/host-picker): Search, sort, and browse every SSH host Bast finds in your config.
- [Host management](https://bast.sh/docs/features/host-management): Add, edit, favorite, hide, and organize SSH hosts with groups, tags, and colors.
- [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.
- [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.
- [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.

- **Reference**
- [Installation](https://bast.sh/docs/reference/install): Install Bast on macOS or Linux via script, Homebrew, or from source.
- [AI agents](https://bast.sh/docs/reference/agents): Install the Bast skill 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.