Skip to content
Back to search

purple

Free, open-source terminal SSH manager and SSH config editor in Rust for macOS and Linux that keeps ~/.ssh/config in sync with 18 cloud providers, monitors live SSH tunnels and manages Docker and Podman containers fleet-wide. Plus scp, Vault SSH certs and an MCP server for AI agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/erickochen/purple with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/erickochen/purple'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/erickochen--purple/badge.svg)](/listings/erickochen--purple)

HTML

<a href="/listings/erickochen--purple"><img src="/api/listings/erickochen--purple/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

curl -fsSL getpurple.sh | sh

<details> <summary>brew, cargo, nix, AUR or from source</summary>

brew install erickochen/purple/purple
cargo install purple-ssh
nix profile install github:erickochen/purple
paru -S purple-bin
yay -S purple-bin
git clone https://github.com/erickochen/purple.git
cd purple && cargo build --release

</details>

Claude Desktop users can install the [.mcpb bundle](https://github.com/erickochen/purple/releases/latest) for one-click MCP integration (read-only by default). Setup details on the [MCP Server wiki](https://github.com/erickochen/purple/wiki/MCP-Server). No data leaves your machine. See [PRIVACY.md](PRIVACY.md).

Run `purple`. Press `?` on any screen for help. That's it.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 176 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="site/purple-logo.svg" alt="purple" width="213" height="48">
  3. </p>
  4. <p align="center"><b>Your ssh config, synced with your cloud.</b></p>
  5. <p align="center">
  6. <a href="https://crates.io/crates/purple-ssh"><img src="https://img.shields.io/crates/v/purple-ssh?color=b44aff&labelColor=0a0a14" alt="crates.io"></a>
  7. <a href="https://crates.io/crates/purple-ssh"><img src="https://img.shields.io/crates/d/purple-ssh?color=b44aff&labelColor=0a0a14" alt="downloads"></a>
  8. <a href="https://github.com/erickochen/purple/stargazers"><img src="https://img.shields.io/github/stars/erickochen/purple?color=b44aff&labelColor=0a0a14" alt="stars"></a>
  9. <a href="LICENSE"><img src="https://img.shields.io/badge/license-mit-b44aff?labelColor=0a0a14" alt="mit"></a>
  10. <a href="https://ratatui.rs/"><img src="https://img.shields.io/badge/built_with-ratatui-b44aff?labelColor=0a0a14&logo=ratatui&logoColor=fff" alt="built with ratatui"></a>
  11. <a href="https://getpurple.sh"><img src="https://img.shields.io/badge/website-getpurple.sh-00f0ff?labelColor=0a0a14" alt="Website"></a>
  12. </p>
  13. **purple is a free, open-source terminal SSH manager and SSH config editor in Rust for macOS and Linux that keeps `~/.ssh/config` in sync with 18 cloud providers, monitors live SSH tunnels and manages Docker and Podman containers fleet-wide.**
  14. Spin up a VM on AWS, GCP, Azure, Hetzner, Proxmox or 13 other cloud providers and it's in your host list before the console catches up. Kill one and purple marks it stale, so your list never lies. No more hand-editing `~/.ssh/config` after every Terraform run, no more digging through cloud consoles for the right IP.
  15. Everything else you do over SSH lives in the same terminal: fuzzy search across hundreds of hosts, visual file transfer, multi-host SSH key push, short-lived HashiCorp Vault SSH certificates and an MCP server for AI agents. Keyboard-driven. Single binary. MIT licensed.
  16. ![purple terminal SSH client demo: searching hosts, monitoring live tunnels, managing containers, running snippets and inspecting keys](demo.gif)
  17. ## Install
  18. ```
  19. curl -fsSL getpurple.sh | sh
  20. ```
  21. <details>
  22. <summary>specific version, brew, cargo, nix, AUR or from source</summary>
  23. Pin a specific version with `PURPLE_VERSION`:
  24. ```
  25. curl -fsSL getpurple.sh | PURPLE_VERSION=1.2.3 sh
  26. ```
  27. ```
  28. brew install erickochen/purple/purple
  29. ```
  30. ```
  31. cargo install purple-ssh
  32. ```
  33. ```
  34. nix profile install github:erickochen/purple
  35. ```
  36. ```
  37. paru -S purple-bin
  38. ```
  39. ```
  40. yay -S purple-bin
  41. ```
  42. ```
  43. git clone https://github.com/erickochen/purple.git
  44. cd purple && cargo build --release
  45. ```
  46. </details>
  47. Claude Desktop users can install the [.mcpb bundle](https://github.com/erickochen/purple/releases/latest) for one-click MCP integration (read-only by default). Setup details on the [MCP Server wiki](https://github.com/erickochen/purple/wiki/MCP-Server). No data leaves your machine. See [PRIVACY.md](PRIVACY.md).
  48. Run `purple`. Press `?` on any screen for help. That's it.
  49. ## Contents
  50. - [Why I built this](#why-i-built-this)
  51. - [What you get](#what-you-get)
  52. - [How purple compares](#how-purple-compares)
  53. - [How it works](#how-it-works)
  54. - [Links](#links)
  55. ## Why I built this
  56. My SSH config was fine. Proper aliases, ProxyJump chains, organized by provider. Not the problem.
  57. The problem was everything around it. Need to check a container? `ssh host docker ps`. Copy a file? `scp` with the right flags. Run the same command on ten hosts? Write a loop or boot up Ansible for a one-liner. Spin up a VM on Hetzner? Open the console, grab the IP, edit config, save. Someone asks which box runs what? Good luck.
  58. I wanted one place for all of that. So I built it.
  59. ## What you get
  60. ### Your ssh config tracks your infra
  61. Drop in one API token per provider. New machines land in `~/.ssh/config` the moment they boot, IPs follow instances as they move and decommissioned hosts gray out instead of lingering. 18 providers including AWS, GCP, Azure, Hetzner, DigitalOcean, Proxmox, Teleport and NetBox, multiple accounts each. On AWS that means a role per account and, with Session Manager on, even the instances with no public address. See the [wiki](https://github.com/erickochen/purple/wiki/Cloud-Providers) for the full list.
  62. ![purple cloud provider list close-up: per-provider sync status with host counts and stale markers](assets/png/zoom-providers.png)
  63. One panel answers the questions you actually have. Is it up. How do I reach it. When was I last on it. What runs there. Connection info, jump route, a year of SSH activity, tags, tunnels and containers per host, with live health dots.
  64. ![purple host list with the detail panel: connection info, jump route, activity sparkline, tags, tunnels and containers](assets/png/hosts.png)
  65. ### Jump to anything with one keystroke
  66. Press `:` and type four letters. Any host, tunnel, container, snippet or action, ranked by how often you use it. It searches the SSH `User`, `ProxyJump` and Vault SSH role too, so typing your username finds every server you log in as. Field prefixes (`user:`, `proxy:`, `vault:`, `tag:`) cut straight to one directive. Like Linear's `Cmd+K`, but in your terminal.
  67. ![purple Jump bar close-up: universal fuzzy search across hosts, tunnels, containers, snippets and actions](assets/png/zoom-jump.png)
  68. ### Manage Docker and Podman on every server, over SSH
  69. Your whole fleet's containers in one list, grouped per host. Shell in, stream logs, restart, stop, exec or kick a whole compose stack member by member. No agent on the remote, no web UI, no extra ports. Just SSH.
  70. ![purple Containers tab close-up: containers across multiple hosts grouped per host with state and uptime](assets/png/zoom-container-fleet.png)
  71. ### Monitor SSH tunnels in real time
  72. Forwards run blind. purple doesn't: every Local, Remote and Dynamic SOCKS forward with live throughput, channel activity and uptime, down to the exact app behind each connection.
  73. ![purple tunnel detail close-up: per-client process roster with live throughput sparklines and a channel swimlane](assets/png/zoom-tunnel-live.png)
  74. ### Run one command across your fleet
  75. Save a command once, run it on any set of hosts. purple shows the blast radius before you fan out and keeps the track record per snippet. "28 of 29 host runs ok" is a number you want to see before production.
  76. ![purple snippet detail close-up: command with parameters, a blast-radius impact card and a host-run track record](assets/png/zoom-snippet-impact.png)
  77. ### Push any SSH key to your fleet, no ssh-copy-id loop
  78. Every key in `~/.ssh`, scored and fingerprinted, with the hosts it unlocks and the last time it was used. Push one to your whole fleet with `p`. Vault-managed hosts skip automatically, so cert-managed stays cert-managed.
  79. ![purple key detail close-up: randomart fingerprint, strength score, agent status and per-key activity](assets/png/zoom-key-randomart.png)
  80. Short-lived certificates from the HashiCorp Vault SSH secrets engine get a TTL strip of their own, so an expiring cert never surprises you.
  81. ![purple Vault SSH close-up: signed certificates with remaining TTL bars per host](assets/png/zoom-vault-ttl.png)
  82. ### And more
  83. - Visual file transfer with a split-pane local and remote explorer.
  84. - Automatic password retrieval from OS Keychain, 1Password, Bitwarden, pass, the HashiCorp Vault KV secrets engine and Proton Pass.
  85. - Short-lived SSH certificates signed via the HashiCorp Vault SSH secrets engine.
  86. - MCP server for AI agents like Claude Code and Cursor, with a read-only mode and a JSON Lines audit log.
  87. - Your own ssh wrapper for interactive logins, such as kitty's `kitten ssh`, via one preference or `PURPLE_SSH_COMMAND`.
  88. - XDG Base Directory support: set `XDG_CONFIG_HOME` and friends (or `PURPLE_CONFIG_DIR` and friends) and purple splits its files into config, data, state and cache. Unset, everything stays in `~/.purple`.
  89. See the [wiki](https://github.com/erickochen/purple/wiki) for details.
  90. ## How purple compares
  91. | | purple | Termius | sshs | Lazydocker |
  92. |---|---|---|---|---|
  93. | Open source | Yes (MIT) | No | Yes | Yes |
  94. | Language | Rust | Electron | Rust | Go |
  95. | Multi-cloud SSH sync | 18 providers | Limited | No | No |
  96. | Containers over SSH | Docker and Podman, fleet-wide | No | No | Local host only |
  97. | Live tunnel monitoring | Yes | No | No | No |
  98. | MCP server for AI agents | Yes | No | No | No |
  99. | Account required | No | Yes | No | No |
  100. | Price | Free | Freemium | Free | Free |
  101. purple keeps your SSH config local and editable: it edits `~/.ssh/config` in place with round-trip fidelity. Use Lazydocker for single-host local Docker, purple for fleet-wide remote management.
  102. ## How it works
  103. purple reads `~/.ssh/config` directly. No database, no daemon, no account. Comments, indentation, include files, unknown directives: all preserved through every edit, so the config you wrote stays the config you have.
  104. Written in Rust. Single binary. 6700+ tests. MIT license.
  105. ## Links
  106. [Wiki](https://github.com/erickochen/purple/wiki) · [Cloud Providers](https://github.com/erickochen/purple/wiki/Cloud-Providers) · [MCP Server](https://github.com/erickochen/purple/wiki/MCP-Server) · [FAQ](https://github.com/erickochen/purple/wiki/FAQ) · [Troubleshooting](https://github.com/erickochen/purple/wiki/Troubleshooting) · [Security](SECURITY.md) · [llms.txt](https://getpurple.sh/llms.txt)
  107. ## Sponsors
  108. purple is free and open source. These people chip in to keep it that way. Thank you!
  109. <a href="https://github.com/alex2chivas"><img src="https://github.com/alex2chivas.png?size=120" width="60" height="60" alt="Alexis Flores"></a>
  110. [Alexis Flores](https://github.com/alex2chivas)
  111. Want to join them? [Sponsor purple on GitHub](https://github.com/sponsors/erickochen).
  112. ## Credits
  113. Screenshots and the demo are generated from the live TUI in [Berkeley Mono](https://usgraphics.com/products/berkeley-mono) by [U.S. Graphics Company](https://usgraphics.com/), recorded with [VHS](https://github.com/charmbracelet/vhs). They regenerate whenever the UI changes on master, so what you see here always matches the current build.
  114. ## Feedback
  115. Bug or feature request? [Open an issue](https://github.com/erickochen/purple/issues).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.