VVTerm

Your servers. Everywhere.

What is VVTerm?

VVTerm is an SSH terminal app for iOS and macOS. Connect to your servers from anywhere with iCloud sync, Keychain security, and a GPU-accelerated terminal.

Features

Terminal

• GPU-accelerated — Powered by libghostty
• Themes — Built-in color schemes with custom theme support
• iOS keyboard — Toolbar with Esc, Tab, Ctrl, arrows, function keys

SSH

• Auth methods — Password, SSH key, key with passphrase
• Keychain storage — Credentials secured in system Keychain
• Multiple tabs — Connect to several servers simultaneously

Sync

• iCloud — Servers and workspaces sync across all devices
• Keychain — Credentials stored locally, not synced

Organization

• Workspaces — Group servers by project or team
• Environments — Tag servers as Production, Staging, Dev
• Color coding — Visual workspace identification

Voice

• Voice-to-command — On-device speech-to-text
• MLX Whisper/Parakeet — Local transcription, no cloud required

Requirements

• macOS 13.0+ (Apple Silicon)
• iOS 16.0+

Building from Source

• Xcode 16.0+
• Swift 5.0+
• Zig (for building libghostty): brew install zig

git clone https://github.com/vivy-company/vvterm.git
cd vvterm

# Build vendor libraries (GhosttyKit + libssh2/OpenSSL)
./scripts/build.sh all

# Open in Xcode and build
open VVTerm.xcodeproj

Installation

Pro Tier

Feature	Free	Pro
Workspaces	1	Unlimited
Servers	3	Unlimited
Tabs	1	Unlimited
Voice commands	-	Yes

Pricing: Monthly ($6.49), Yearly ($19.99), Lifetime ($29.99)

Architecture

VVTerm/
├── Models/                 # Server, Workspace, Environment
├── Managers/
│   ├── ServerManager       # Server/Workspace CRUD + sync
│   └── ConnectionSession   # Tab/connection lifecycle
├── Services/
│   ├── SSH/                # libssh2 wrapper
│   ├── CloudKit/           # iCloud sync
│   ├── Keychain/           # Credential storage
│   ├── Store/              # StoreKit 2 (Pro tier)
│   └── Audio/              # Voice-to-command
├── Views/
│   ├── Sidebar/            # Server list, workspaces
│   ├── Terminal/           # Terminal container
│   ├── Tabs/               # Connection tabs
│   └── Settings/           # All settings panels
└── GhosttyTerminal/        # libghostty wrapper

Patterns:

• MVVM with @Observable
• Actor model for concurrency
• CloudKit for persistence
• SwiftUI + async/await

Dependencies

• libghostty — Terminal emulator
• libssh2 — SSH protocol
• OpenSSL — Cryptography

Third-Party Notices

See THIRD_PARTY_NOTICES.md.

Contributing

See CONTRIBUTING.md for contribution workflow and CLA.md for the required CLA process.

Security

See SECURITY.md for vulnerability reporting guidelines.

License

VVTerm uses a dual-license model:

• Source code (this repository): GNU General Public License v3.0 (LICENSE)
• Official App Store binaries: App Store EULA + VVTerm Terms (LICENSE-APPSTORE.md, https://vvterm.com/terms)

If you obtain VVTerm from source and build it yourself, GPL-3.0 applies. If you obtain VVTerm via Apple's App Store, App Store EULA terms apply to that binary distribution.

GNU General Public License v3.0

Copyright © 2026 Vivy Technologies Co., Limited