Welcome to sshman Discussions!

[SpikeTheDragon40k]

👋 Hey, welcome to sshman!

Thanks for stopping by! I'm Adriano, and I built sshman to scratch a very specific itch: managing SSH keys and connections in a way that’s secure by design but still convenient to use in day-to-day ops. Instead of leaving private keys lying around as files in ~/.ssh, sshman keeps everything encrypted in a vault (vault.vssh) using Argon2id and AES-GCM, and only loads keys into memory when needed.[cite:2]

This Discussions area is our little hub to talk about all things sshman — from “how do I…?” questions to crazy feature ideas and deep dives into how the vault and crypto work under the hood.[cite:2]

---

💬 What to use this for

Feel free to start a discussion if you want to:

• Ask questions — Installation issues, usage questions, “am I doing this right?” scenarios — all welcome.
• Propose features — YubiKey/TOTP integration, more key types (ED25519, ECDSA, etc.), GUI ideas, keyring integration… dream big.
• Share feedback — Rough edges, confusing UX, or “this saved me so much time” stories.
• Talk security — Key handling, vault format, Argon2id parameters, threat models — security-focused feedback is especially appreciated.[cite:2]
• Coordinate contributions — Want to work on something from the To-Do list in the README? Let’s talk about it first so we can align on approach.[cite:2]

If it’s not a clear bug or feature request yet, a Discussion is usually the perfect place to start.

---

🚀 New here? Try this

If you’re just getting started, a typical flow looks like:

git clone https://github.com/SpikeTheDragon40k/sshman.git
cd sshman
go build -o sshman main.go

# Initialize your encrypted vault
./sshman init

# Add an entry
./sshman add --name myserver --user ubuntu --host 1.2.3.4 --key ~/.ssh/myserver.key

# List, copy, or connect
./sshman list
./sshman copy --name myserver
./sshman connect --name myserver

You can also generate keys (genkey) and send public keys to servers (sendkey) without ever writing the private key to disk outside the vault.[cite:2]