Agent/improve positioning

COMPARISON.md

@@ -1,73 +1,94 @@
-# One app for your terminal and your servers
-
-Sarv Terminal is a fast, GPU-accelerated terminal **and** a full SSH client in one native macOS
-app — saved hosts, SSH keys, SFTP, tunnels, and end-to-end-encrypted sync, all built in. No
-plugins, no separate SSH manager, no config-file spelunking.
-
-## Everything you get
-
-- **Import — switch in minutes.** Bring hosts in from `~/.ssh/config` (including `Include`d files),
-  iTerm2, CSV, PuTTY, MobaXterm and SecureCRT, and pull your appearance & keybindings from Ghostty,
-  Alacritty, Kitty, iTerm2 and WezTerm.
-- **Saved-host vault.** Every server with its full SSH profile — user, port, identity file, agent
-  forwarding, proxy jump, host-key policy, startup command — in workspace → project folders with
-  tags and per-host color themes.
-- **SSH key manager.** See every key in `~/.ssh`, generate Ed25519 / ECDSA / RSA-4096, copy the
-  public key, reveal in Finder, or delete — no `ssh-keygen` incantations.
-- **SFTP + SCP file manager.** Dual-pane local↔remote browsing plus direct server-to-server copies,
-  live progress, an in-app file editor, and an rwx / octal permissions editor.
-- **Port-forward manager.** Save and run Local (`-L`), Remote (`-R`) and Dynamic / SOCKS (`-D`)
-  tunnels over any saved host, with start/stop and live status.
-- **Zero-knowledge sync.** Move your whole setup between Macs under encryption only you can open —
-  AES-256-GCM, master password in the Keychain behind Touch ID, your own GitHub repo or synced folder.
-- **AI command assist.** When a command fails, get a one-click explanation and a suggested fix you
-  can paste straight in — bring your own key, using Claude, OpenAI or a local Ollama model. Your key
-  is stored encrypted on your Mac and never synced.
-- **Docker & Kubernetes attach.** List your running containers and pods and open a shell inside any
-  of them in a click — no `docker exec` / `kubectl exec` to remember.
-- **Snippets & shell history.** A library of your most-used commands; browse recent shell history
-  and save any command as a snippet in a click.
-- **Serial console.** Connect to routers, switches, a Raspberry Pi or a microcontroller over
-  USB-serial — pick the device and baud rate, opens right in a tab.
-- **Terminal workspace.** Tabs and splits, focus mode, input broadcasting, tab colors and renaming,
-  an all-tabs overview, and reopen-closed-tab.
-- **Known-hosts manager & activity logs.**
-- **Customization.** Themes and per-host themes, background image with opacity and blur,
-  font / cursor / window controls, and fully rebindable keybinds.
-
----
-
-## How it compares
-
-Other terminals can run `ssh` — but the connection-manager layer that makes servers easy to live
-with isn't built in.
-
-**Legend:** ✅ built-in · 🟡 partial · ⬜ not offered.
-🟡 usually means the tool can run `ssh`, but has no proper GUI to manage it — no host vault, key
-manager, or tunnel UI.
-
-| | **Sarv Terminal** | Ghostty | iTerm2 | Warp | Terminal.app | WezTerm |
-|---|:---:|:---:|:---:|:---:|:---:|:---:|
-| Saved-host vault (groups, per-host identity & proxy-jump) | ✅ | ⬜ | 🟡 | ⬜ | 🟡 | 🟡 |
-| SSH key manager (generate / list / copy in-app) | ✅ | ⬜ | ⬜ | ⬜ | ⬜ | ⬜ |
-| SFTP / SCP dual-pane file manager | ✅ | ⬜ | 🟡 | ⬜ | ⬜ | ⬜ |
-| Port-forward / tunnel manager (GUI) | ✅ | ⬜ | ⬜ | ⬜ | ⬜ | ⬜ |
-| Import hosts & settings from other apps | ✅ | ⬜ | 🟡 | ⬜ | ⬜ | 🟡 |
-| End-to-end-encrypted settings sync | ✅ | ⬜ | 🟡 | 🟡 | ⬜ | ⬜ |
-| AI explain/fix for failed commands (bring-your-own-key, local option) | ✅ | ⬜ | ⬜ | 🟡 | ⬜ | ⬜ |
-| One-click Docker / Kubernetes container attach | ✅ | ⬜ | ⬜ | ⬜ | ⬜ | ⬜ |
-| Serial console (USB-serial) | ✅ | ⬜ | ⬜ | ⬜ | ⬜ | ✅ |
-| Known-hosts manager | ✅ | ⬜ | ⬜ | ⬜ | ⬜ | ⬜ |
-| GPU-accelerated rendering | ✅ | ✅ | ✅ | ✅ | ⬜ | ✅ |
-| GUI settings (no config file required) | ✅ | 🟡 | ✅ | ✅ | ✅ | ⬜ |
-| Local-first · no account · no telemetry | ✅ | ✅ | ✅ | 🟡 | ✅ | ✅ |
-| Open source & free | ✅ | ✅ | ✅ | 🟡 | ⬜ | ✅ |
-| License | MIT | MIT | GPL-2.0 | AGPLv3 (client) | Proprietary | MIT |
-
-> If you manage more than one server, Sarv Terminal is the only app here that puts your terminal,
-> saved hosts, SSH keys, tunnels and file transfers in **one place** — fast, local-first, and
-> zero-knowledge, with nothing leaving your Mac. That's the whole workflow the others leave you to
-> assemble by hand.
-
-<sub>Sarv Terminal is macOS-only today (the Ghostty engine is cross-platform; a Linux UI is the
-project's biggest open item). Comparison reflects built-in GUI capabilities as of 2026.</sub>
+# A native Mac terminal built for server work
+
+Sarv Terminal combines the fast, GPU-accelerated Ghostty engine with the workflows normally found
+in dedicated SSH clients: saved connections, SSH keys, SFTP/SCP, tunnels, encrypted settings sync,
+container attach, and command-failure assistance.
+
+That places Sarv Terminal between two established categories. Terminal emulators optimize the local
+command-line experience. Dedicated SSH managers optimize fleets of remote connections. Sarv Terminal
+is for Mac users who want both in one open-source app.
+
+## Where we fit
+
+| Product | Positioning | Main trade-off |
+|---|---|---|
+| **Sarv Terminal** | We combine a native macOS terminal with visual SSH operations for people who manage multiple servers. | macOS-only today; saved-host passwords are not yet stored in Keychain. |
+| **Ghostty / iTerm2 / WezTerm** | Excellent terminal experiences with remote workflows assembled from `ssh`, `scp`, `tmux`, and other tools. | No full built-in server-operations workspace. |
+| **Termius / SecureCRT** | Cross-platform coverage, mature enterprise SSH administration, and mobile access. | Proprietary/commercial products rather than an open-source Mac-native stack. |
+| **Warp** | Agentic coding and an editor-like command workflow. | Different focus from a saved-host, SFTP, key, and tunnel manager. |
+| **Tabby** | Cross-platform open-source terminal access with SSH, Telnet, and serial support. | Electron-based and less focused on a native macOS server workspace. |
+
+## Compared with terminal emulators
+
+**Legend:** ✅ built in · 🟡 partial, optional, or adjacent capability · ⬜ not documented as built in.
+
+| Capability | **Sarv Terminal** | Ghostty | iTerm2 | Warp | WezTerm |
+|---|:---:|:---:|:---:|:---:|:---:|
+| GPU-accelerated terminal | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Saved-host workspace with groups, identity, and proxy jump | ✅ | ⬜ | 🟡 | ⬜ | 🟡 |
+| SSH key-management UI | ✅ | ⬜ | ⬜ | ⬜ | ⬜ |
+| SFTP/SCP file-management UI | ✅ | ⬜ | 🟡 | ⬜ | ⬜ |
+| GUI for local, remote, and SOCKS tunnels | ✅ | ⬜ | ⬜ | ⬜ | ⬜ |
+| Failure explanation + suggested fix with BYOK/local-model option | ✅ | ⬜ | 🟡 | 🟡 | ⬜ |
+| One-click Docker/Kubernetes shell attach | ✅ | ⬜ | ⬜ | ⬜ | ⬜ |
+| No account required for the core terminal | ✅ | ✅ | ✅ | 🟡 | ✅ |
+| Open-source license | MIT | MIT | GPL-2.0 | AGPL-3.0 client | MIT |
+
+iTerm2 offers an optional generative-AI plugin, so it is marked partial rather than absent. Warp has
+broad built-in AI/agent capabilities, but its product focus is agentic development rather than the
+BYOK/local failed-command workflow described in this row.
+
+## Compared with SSH and connection managers
+
+This is the more important competitive set for Sarv Terminal's server-management features.
+
+| Capability | **Sarv Terminal** | Termius | SecureCRT | Tabby |
+|---|:---:|:---:|:---:|:---:|
+| Terminal + saved connections | ✅ | ✅ | ✅ | ✅ |
+| Keys/credentials managed through the app | ✅ | ✅ | ✅ | 🟡 |
+| GUI port-forwarding workflow | ✅ | ✅ | ✅ | 🟡 |
+| Encrypted multi-device settings/host sync | ✅ user-controlled backend | ✅ Termius cloud vault | ⬜ not documented as built in | ⬜ not documented as built in |
+| BYOK/local command-failure assistance | ✅ | ⬜ | ⬜ | ⬜ |
+| One-click Docker/Kubernetes shell attach | ✅ | ⬜ | ⬜ | ⬜ |
+| Desktop platforms | macOS | macOS, Windows, Linux + mobile | macOS, Windows, Linux | macOS, Windows, Linux |
+| Product model | Free, open source | Proprietary, subscription tiers | Commercial | Free, open source |
+
+## The honest positioning
+
+Sarv Terminal's advantage is not that other products cannot connect to servers. Termius and
+SecureCRT are mature connection managers, while Ghostty, iTerm2, Warp, WezTerm, and Tabby are strong
+terminal products.
+
+The differentiator is the combination: **a native macOS terminal built on Ghostty, plus a visual
+server-operations workspace, released under MIT and usable without a mandatory account.** We focus
+on a Mac-first, open-source and local-first workflow. Cross-platform SSH managers remain the stronger
+fit when mixed-device and mobile support are the priority.
+
+## Security and privacy scope
+
+Sarv Terminal does not require an account and does not bundle product telemetry. Local data stays on
+the Mac unless an optional feature that communicates externally is enabled:
+
+- encrypted sync writes to the selected private GitHub repository or synced folder;
+- AI assistance sends the relevant request to the configured provider, or stays local with
+  Ollama;
+- saved-host passwords currently remain in local `hosts.json`; SSH keys are recommended until the
+  planned Keychain migration lands.
+
+## Sources and methodology
+
+Checked **2026-07-21** against vendor documentation and public repositories. The table covers
+built-in, user-visible product capabilities rather than everything achievable with scripts or
+third-party extensions. Features, editions, and pricing can change; corrections are welcome.
+
+- [Sarv Terminal README](README.md)
+- [Ghostty features](https://ghostty.org/docs/features)
+- [iTerm2 features](https://iterm2.com/features.html) and [AI plugin](https://iterm2.com/ai-plugin.html)
+- [Warp repository](https://github.com/warpdotdev/warp)
+- [WezTerm repository](https://github.com/wezterm/wezterm)
+- [Termius Vault](https://termius.com/vault)
+- [SecureCRT features](https://www.vandyke.com/products/securecrt/features.html)
+- [Tabby repository](https://github.com/Eugeny/tabby)
+
+<sub>Sarv Terminal is macOS-only today. Its Ghostty-derived terminal engine is cross-platform, but
+the connection-manager interface is currently implemented in SwiftUI.</sub>