Hermit

Hermit

A focused iOS SSH client built for developers who live in tmux and Claude Code.

Hermit is not a general-purpose terminal emulator. It connects to remote dev machines, attaches to named tmux sessions, and provides configurable soft keys and voice input for working with Claude Code from your phone.

[Download from the iOS App Store](https://apps.apple.com/us/app/hermit-ssh/id6760623047)

Features

• SSH connections with private key authentication
• tmux session attach or raw shell
• Configurable ribbon bar with soft keys (send strings, ESC, voice input)
• xterm.js terminal rendering via WKWebView
• Super Whisper voice transcription integration
• Automatic iCloud Drive sync across devices
• Dark mode enforced
• Portrait-only for v1

Requirements

• iOS 17+
• Xcode 16+

Getting Started

1. Clone the repo
2. Open Hermit/Hermit.xcodeproj in Xcode
3. Build and run on a simulator or device

iCloud Drive Sync

Session and host configuration is stored in `hermit-data.json` in your iCloud Drive container. This syncs automatically across all devices signed into the same iCloud account. You can edit this file directly from a Mac:

# In Finder
iCloud Drive → Hermit → Documents → hermit-data.json

# Or via terminal
~/Library/Mobile Documents/iCloud~com~zeromissionllc~hermit/Documents/hermit-data.json

Private keys are stored in the iOS Keychain and do not sync — they must be added per device.

Fastlane

TestFlight and App Store deployment is automated via Fastlane.

cd Hermit
bundle install
cp fastlane/.env.example fastlane/.env
# Fill in your credentials in .env
bundle exec fastlane beta      # Upload to TestFlight
bundle exec fastlane release   # Submit for App Store review

See `fastlane/.env.example` for required environment variables.

Architecture

Concern	Decision
Language	Swift, SwiftUI
SSH Library	Citadel (SwiftNIO SSH) — integra