VVTerm

Your servers, always with you.

VVTerm is an SSH terminal app for iOS and macOS. It uses Ghostty for terminal rendering, libssh2 and OpenSSL for SSH transport, CloudKit for sync, and Keychain for local credential storage.

Installation

Requirements

• Apple Silicon Mac
• Xcode 16.0 or later
• macOS 13.3 or later
• iOS 16.1 or later
• Zig and CMake

Install the command-line build tools with Homebrew:

brew install zig cmake

Build From Source

git clone https://github.com/vivy-company/vvterm.git
cd vvterm
./scripts/build.sh all
open VVTerm.xcodeproj

The build script supports all, ghostty, ssh, verify, clean, and help.

Project Structure

VVTerm/
├── App/                 # App entry and dependency composition
├── Core/                # Shared infrastructure
├── Features/            # Product features
└── Resources/           # Assets, themes, terminfo, and localizations

VVTerm-iOS/              # iOS configuration
VVTerm-macOS/            # macOS configuration
VVTermLiveActivity/      # ActivityKit target
VVTermShared/            # Types shared with the ActivityKit target
VVTermTests/             # Unit and integration tests
VVTermUITests/           # UI tests
Vendor/                  # Native dependencies
scripts/                 # Build and validation scripts
web/                     # Website for vvterm.com

Feature code uses four boundaries:

• Domain for pure types and rules
• Application for state and workflows
• Infrastructure for persistence, transport, and adapters
• UI for SwiftUI, AppKit, and UIKit presentation

Main Dependencies

• libghostty for terminal emulation and rendering
• libssh2 for SSH transport
• OpenSSL for cryptography

Xcode resolves the Swift package dependencies in the project.

Documentation

• CONTRIBUTING.md for the contribution workflow
• SECURITY.md for vulnerability reports
• THIRD_PARTY_NOTICES.md for third-party notices
• CLA.md for the contributor license agreement

License

Source code in this repository is available under the GNU General Public License v3.0. Official App Store binaries use the VVTerm App Store EULA.

Copyright © 2026 Vivy Technologies Co., Limited