Chuchu renders your terminal using libghostty — the same VT engine that powers the Ghostty desktop terminal emulator. This gives you a fully capable, hardware-accelerated terminal on Android with accurate color rendering, scrollback, mouse event support, and inline image display.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.
VT and color support
The terminal emulator supports the full VT/ANSI escape sequence set, including 256-color mode and 24-bit truecolor. When Chuchu opens an SSH session, it advertises the terminal typexterm-ghostty as the TERM environment variable and sends COLORTERM=truecolor so that color-aware programs know they can use 24-bit RGB values.
Scrollback
You can scroll through the terminal’s history at any time. The scrollback buffer holds up to 1,000 lines. Chuchu provides two scroll behaviors:- Scroll by delta — swipe or use scroll gestures to move through history line by line.
- Scroll to active — instantly jump back to the bottom of the buffer, returning to the live shell prompt.
Terminal resize
When you rotate your device, split the screen, or change the font size, Chuchu recalculates the column and row count based on the physical cell dimensions and sends a PTY resize signal to the remote shell. The terminal redraws immediately at the new size without interrupting your session.Mouse event support
Chuchu encodes and forwards mouse events — clicks, scroll gestures, and drag operations — using the Ghostty mouse protocol. The physical screen dimensions and cell sizes are kept in sync so that the remote application receives accurate cursor coordinates. This makes mouse-driven TUI applications such ashtop, vim, and tmux fully interactive.
Focus events
When the app moves to the foreground or background, Chuchu sends a focus event to the remote shell. Terminal applications that listen for focus events (many editors and multiplexers do) can use this signal to update their state — for example, checking for file changes when you switch back to the app.Kitty image protocol
Chuchu supports the Kitty image protocol for rendering inline images directly in the terminal. When a remote program sends image data using this protocol, Chuchu detects that an image is loading, waits for the transfer to complete, and then renders the image in-place inside the terminal canvas. This enables tools liketimg, viu, and any program that targets the Kitty protocol to display graphics in your session.
Bell notifications
When a remote program triggers the terminal bell (for example, a command completes or an alert fires), Chuchu responds with haptic feedback on your device — a short vibration that lets you know something requires your attention even when the screen is not in focus.Title and working directory
Chuchu polls the terminal for a dynamic window title and the current working directory. The current directory is displayed in the top-right corner of the terminal screen so you always know where you are in the filesystem without runningpwd.
Accessory key bar
The accessory key bar appears above the software keyboard and gives you one-tap access to keys that are difficult to type on a touchscreen. You can configure both which keys appear and how the bar is laid out.Configure the accessory bar
Open Settings
From the terminal screen, tap the settings icon to open Settings, then select the Terminal category.
Customize accessory keys
Tap Customize next to “accessory keys” to open the key editor. Toggle keys on or off from the full catalog. Long-press a key in the preview strip and drag left or right to reorder it.
Choose single-row or double-row layout
Toggle single-row accessory bar to switch between a compact single row and the default two-row layout. The two-row layout fits more keys without horizontal scrolling.