ShellDock
An open-source native macOS workspace, written in SwiftUI and AppKit, for managing SSH sessions and SFTP files side by side.
- Year
- 2026
- Status
- Beta · My own product
ShellDock grew out of the constant back-and-forth between a terminal and a file transfer tool when working with servers. SSH tabs, an SFTP browser and a transfer queue work together in a single native macOS window. The app is open source under the MIT license and currently in beta.
Architecture
The interface is built with SwiftUI and AppKit, and terminal emulation with SwiftTerm. Instead of implementing its own SSH stack, the app uses the OpenSSH tools that ship with macOS, launching them with argument vectors rather than through a shell. Transport and storage sit behind protocols so they can be replaced without rewriting the interface. Every major decision is documented in an architecture decision record (ADR): SSH transport, terminal emulator, SFTP transport and Finder integration.
Security
Passwords and private-key passphrases are stored in the macOS Keychain. Unknown or changed host keys are never accepted without an explicit trust decision. Control sockets and temporary trust files are created with private permissions and cleaned up with their session. The diagnostics report generated for support excludes connection identities, paths and terminal output.
File Flow
Uploads can start from Finder drag and drop, the Finder Services menu or by dropping items on the Dock icon. Folders are merged on transfer; conflicts can be replaced, skipped or reviewed one by one. Transfers can be queued, paused, resumed and retried. Local and remote folders can be compared and synchronized, files verified with SHA-256 and copied between servers.
Quality
Tests written with Swift Testing cover session restoration, terminal sizing, OpenSSH configuration, transfer accounting and diagnostics redaction. Real SSH/SFTP tests run against a disposable server in Docker, and CI runs on GitHub Actions.
Architecture
Components and the flow between them.
