GitHub - jossephus/chuchu: native android ssh client based on libghostty · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
jossephus
chuchu
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star<br>96
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>141 Commits<br>141 Commits
.github
.github
android
android
assets
assets
docs
docs
zig-src
zig-src
.gitignore
.gitignore
AGENTS.md
AGENTS.md
LICENSE
LICENSE
Makefile
Makefile
README.md
README.md
devshell.nix
devshell.nix
flake.lock
flake.lock
flake.nix
flake.nix
View all files
Repository files navigation
Chuchu
A Modern, Better, Native Android SSH client powered by libghostty
Download Latest ·<br>ChangeLog ·
Chuchu is a native Android SSH client powered by libghostty, a terminal-first Compose UI, and has support for both standard SSH and Tailscale SSH workflows.
Features
tailscale, ssh password + key authentication
image display using libghostty's kitty image protocol support
more than 400 themes from the official ghostty repository
configurable accessory keys
beautiful and working terminal renderer with fully working resize, scrollback, focus, modifier keys, mouse actions
Status
Chuchu is in active development. I am daily driving it and improving any issues i found in the way. Join the journey and report any bugs you find. And I welcome any contributions.
Getting Started
Checkout our releases and download the apk from there. The latest release will have the latest changes.
I don't have a personal Play Store account right now (and I can't open one because of the payment limitation in my country, feel free to contact me if you want to publish it.)
Stack
Kotlin + Jetpack Compose for the Android app
Zig for native build orchestration and JNI/native bridge code
Ghostty VT for terminal emulation
libssh2 + openssl for the current native SSH path
Room for local data storage
Development - Prerequisites
If you have nix installed, the following three steps will get you started
nix develop - will set you up with everything you will need.
running 'make build' will build the native code needed
running 'make app' will build the apk and install it in a connected device.
If you don't have nix installed, you will need
setup tools
Android Studio - This will set up the needed Android SDK, Android NDK and Java runtime (JDK 17+).
Zig 0.15.2
build the native library
Set ANDROID_NDK_HOME or ANDROID_NDK_ROOT, then build the JNI library for Android arm64:
zig build jni -Dtarget=aarch64-linux-android
That copies libchuchu_jni.so into app/src/main/jniLibs/arm64-v8a/.
From android studio run
./gradlew assembleDebug
Inspiration
I have been using vvterm on iOS for the past few weeks and i really liked it. This project came from my desire to have native ssh client but for android.
Project Name
chuchu is one of my favorite characters from the amharic book Yesinbit Kelemat [translated to colors of adios].
Demo
About
native android ssh client based on libghostty
chuchu.jossephus.et/
Resources
Readme
License
MIT license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
96<br>stars
Watchers
watching
Forks
forks
Report repository
Releases<br>12
v0.3.1
Latest
May 25, 2026
+ 11 releases
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Kotlin<br>77.3%
Zig<br>21.1%
Shell<br>1.2%
Other<br>0.4%
You can’t perform that action at this time.