
detour
io.github.INotSleep/detour
Work on your SSH servers without seeing passwords or keys: you approve each host and right.
Documentation
Detour
An SSH client for teams, with no server in the middle.
Hosts, keys and passwords are shared through a Git repository or a folder you already have,
encrypted end to end and signed on every change.
Download · App Store · Docs · Discussions · Security design · Build from source
Features
- Terminal. Tabs, split panes, search, themes. Output that comes without colours gets them: the prompt, paths, addresses, sizes and status words. Copy and paste like your system terminal, or like Termius.
- SFTP. Files and whole folders with progress and cancel, permissions, a terminal in the current folder. A failed transfer never leaves a half-written file.
- Tunnels. Local (
-L), remote (-R) and SOCKS (-D) forwarding. - Proxies. Chains of jump hosts (
-J), and saved proxies hosts go through: SOCKS5, HTTP, WireGuard (only for Detour, no system VPN) and VLESS over TCP or XHTTP with TLS, REALITY and Vision. From avless://link or a.conffile. - Import.
~/.ssh/configwithInclude, patterns andProxyJump, keys andknown_hosts. - All your devices. Your vault syncs between them. A new device joins with a one-time code.
- iPhone and iPad. Detour SSH on the App Store: the terminal with a key bar of your own, files over SFTP, keys, snippets, Face ID, sync and teams.
- Teams. Access per host, key and snippet, per person.
- Command line.
detourdoes everything the app does, in a terminal and on servers without a desktop. More - AI agents. Claude Code, Codex, Cursor and others work on your servers over MCP, only where and for as long as you allow, without ever seeing a password or key. More
Security
Detour treats the storage, the network and every other member's computer as hostile. There is no Detour server to trust or to breach.
| If | Then |
|---|---|
| your Git host or shared folder leaks | the attacker gets ciphertext. Names, addresses, logins, members and who can see what are encrypted. |
| the storage alters, reorders, hides or rolls back changes others have seen | every member's Detour detects it and says so. |
| a teammate's copy of Detour is modified | it still holds only the keys that teammate was given. Access is enforced by encryption, not by the app. |
| someone is removed from a team | the rest of the team moves to new keys. Nothing written afterwards is readable to them. |
| your laptop is stolen | the vault is sealed with your master password and locks itself when idle. |
| a server's host key changes | the connection stops before any password or key is sent. |
| a Detour ID is swapped on its way to an admin | the fingerprints you compare don't match. |
| someone publishes a fake update | the app refuses it: updates must carry the project's signature. |
| an AI agent goes further than asked | it reaches only the hosts and rights you allowed, for the time you chose, never sees a password or key, and can't accept a new server key. |
Built on age (X25519, scrypt), ChaCha20-Poly1305, Ed25519 signatures and per-device hash chains, russh and rustls. No accounts, no telemetry.
The full design, including what cryptography can't protect against: docs/teams.md.
Teams
- Create a team in a Git repository (any SSH or HTTPS remote) or in a shared folder (Syncthing, Dropbox, OneDrive, SMB).
- Add a teammate by the Detour ID they send you, and pick what they can see.
- They open the same repository or folder.
Install
Installers for macOS, Windows and Linux are on the Releases page. Detour updates itself from there. They put the detour command line on your PATH too; for servers without a desktop, the release has it alone (detour-cli-<version>-<system>).
For iPhone and iPad, get Detour SSH from the App Store.
The interface is in English and Russian.
Privacy
Detour sends nothing to anyone except the servers, repositories and folders you set up yourself, and GitHub releases when it checks for updates (this can be turned off in Settings).
Build from source
Requirements: Node 20+, Rust (stable), and the Tauri prerequisites for your system.
npm install
npm run tauri dev # the desktop app
npm run dev # the UI alone in a browser, with demo data
cargo run -p detour-cli -- --help # the command line
cargo test --workspace
Release builds
Release builds sign their update files with the updater key: set TAURI_SIGNING_PRIVATE_KEY (and TAURI_SIGNING_PRIVATE_KEY_PASSWORD if it has one), or build without update files:
npm run tauri build -- --config src-tauri/tauri.bundle.conf.json --config "{\"bundle\":{\"createUpdaterArtifacts\":false}}"
tauri.bundle.conf.json builds the command line (scripts/sidecar.mjs) and puts it into the installers, with the PATH set up on Windows (src-tauri/windows/).
CI builds the macOS and Linux installers and the command line archives for every v* tag into a draft release. The Windows ones are signed with a Certum code signing certificate in SimplySign, so they are built locally and added to that draft by scripts/release-windows.ps1. It then makes the MCP bundle (detour-<version>.mcpb, for Claude Desktop and the MCP Registry) with scripts/mcpb.py, which also updates server.json for mcp-publisher publish.
Layout
crates/detour-core/ SSH, SFTP, vaults, team sync, crypto. No UI dependencies.
crates/detour-ipc/ the protocol between the core and its clients
crates/detour-daemon/ the core as a process: sessions, tunnels, sync, AI agents
crates/detour-cli/ the `detour` command line and MCP server
src-tauri/ Tauri 2 shell: the window, the tray, a proxy to the core
src/ React + TypeScript UI, xterm.js terminal
lib/api.ts the only boundary between the UI and the core
Contributing
Issues and pull requests are welcome. Contributions are published under the project's license. cargo test --workspace and npx tsc --noEmit must pass.
License
Detour is free software under the GNU AGPL v3 with the additional terms in NOTICE.
Use it anywhere, including at work, at no cost. Whoever distributes a modified version, or runs one as a network service, must publish its source under the same license, credit it as Based on Detour with a link to this repository, and must not call it Detour.
https://github.com/INotSleep/Detour/releases/download/v0.5.0/detour-0.5.0.mcpb# mcpb: https://github.com/INotSleep/Detour/releases/download/v0.5.0/detour-0.5.0.mcpb