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 includes a built-in SFTP file browser that lets you navigate your server’s filesystem and upload files from your device without switching to a separate app. The browser is built on libssh2’s SFTP subsystem and reuses your active SSH session — no separate authentication or second connection is needed.
SFTP uses the same SSH session as the terminal. You do not need to authenticate again to use the file browser.

​
What the file browser shows

When you open the file browser, Chuchu lists the contents of the current directory. Each entry shows:
  • Name — the file or directory name
  • Type — file, directory, or symlink
  • Size — human-readable file size (for example, 1.4 mb)
  • Modified time — the last modification timestamp
You can filter the listing by typing in the search field at the top. Use the sort button to sort by name, size, or modification time. Symlinks and directories are tappable — tapping them navigates into that path. Regular files do not open for viewing in this release.

​
Path resolution

When the file browser opens, Chuchu resolves your home directory path using SFTP’s realpath function. This converts ~ and relative paths to their absolute equivalents, so the path bar always shows the full path of your current location.

​
Upload files

Chuchu uploads files in 32 KB chunks over the SFTP write stream. Progress is shown in a dialog during the upload.
File uploads use the WRITE | CREAT | TRUNC flags. If a file with the same name already exists at the destination, it will be overwritten without warning.

​
Upload a file to your server

1

Connect to a server

Open a terminal session by tapping a server on the server list screen.
2

Open the file browser

In the terminal screen, tap the folder icon in the accessory bar or navigation area to switch to the file browser tab.
3

Navigate to the destination directory

Tap directories to navigate into them. Use the back arrow (or the ← button at the bottom) to go up one level. You return to the terminal tab when you reach the root or your home directory and press back.
4

Tap the upload button

Tap the ↑ button at the bottom of the file browser. Your device’s file picker opens — select one or more files.
5

Wait for the upload to complete

A progress dialog shows the file name, bytes written, total size, and percentage complete. If you are uploading multiple files, the dialog also shows which file is currently uploading (for example, “file 2 of 5”).
After the upload finishes, a toast message confirms how many files were uploaded successfully. If any file failed, the error message is included in the toast.

​
Copy a path

Each file and directory entry has a copy button on the right side. Tap it to copy the full remote path to your clipboard, which you can paste directly into the terminal.

Build docs developers (and LLMs) love

Get started for freeTalk to us