Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/jossephus/chuchu/llms.txt

Use this file to discover all available pages before exploring further.

Chuchu is a native Android SSH client built on libghostty — the terminal rendering engine behind the Ghostty desktop emulator. It gives you a full, responsive terminal on Android with genuine VT emulation: resize, scrollback, modifier keys, mouse actions, and image display via the Kitty image protocol. Instead of a web-view or a thin wrapper, Chuchu renders every character natively on-device.

Key features

  • Three transport types — standard SSH, Tailscale SSH, and Mosh, selectable per server
  • Password and public key authentication — including Ed25519 key generation on-device and optional key passphrase protection
  • 400+ themes — sourced from the official Ghostty theme repository, switchable instantly
  • SFTP file browser — browse and transfer files on remote servers without leaving the app
  • SSH key generation — create and manage Ed25519 keys directly in the app
  • Biometric lock — require fingerprint or face authentication before connecting
  • Auto-reconnect — automatically reconnects with exponential backoff if the connection drops unexpectedly
  • Configurable accessory key bar — quick access to Ctrl, Esc, Tab, and other modifier keys

Transport types

Chuchu supports three ways to reach a remote host:
TransportWhen to use
SSHStandard SSH over TCP — works with any sshd-compatible server
Tailscale SSHConnect through your Tailscale mesh network using a Tailscale IP or MagicDNS name
MoshUDP-based transport that survives network changes and high-latency connections

Requirements

Chuchu requires Android 7.0 or higher (API level 24) and runs on arm64 devices (arm64-v8a ABI).

Where to go next

Installation

Download the APK from GitHub releases and install it on your device.

Quick start

Add your first server and open a terminal session in minutes.

SSH connections

Connect with password or public key auth, including host key verification.

Terminal features

Explore the libghostty renderer: themes, images, scrollback, and more.

Build docs developers (and LLMs) love