Clio: Your Terminal Assistant

Stop memorizing commands. Ask in plain English and Clio suggests the right shell command — with confirmation before anything runs.
Works offline-first on Linux, macOS, and Android (Termux). Modules download from this registry on demand.

terminal Install Clio explore Browse Modules upload Share Your Module
terminal

$ clio

CLIPilot Client (Offline First) - Type 'catalog', 'setup', or ask anything

>> list files in this folder

⌨️ SHELL COMMAND

ls -F

Run command? (y/n)

>> setup termux

⭐ [SETUP WIZARD] — exit Clio, then run in shell ↓

REPL vs Shell — Where Commands Run

Clio has two prompts. Using the wrong one for module workflows causes errors on Termux.

Prompt What it is Use for
>> Clio REPL (inside clio) Plain-English questions, setup, modules, catalog, sync
$ Your normal shell (Termux, bash, zsh) clio-run-module … and anything Clio tells you to run after exiting

⚠️ Do not paste clio-run-module at the >> prompt

Setup wizards and automation modules are bash workflows. On Termux/Android they must run via the clio-run-module script in your normal shell, not inside the Clio REPL. Pasting the command at >> can mislabel it as an automation module or crash with SIGSYS: bad system call.

Running a setup wizard (correct flow)

Step 1 — Inside Clio REPL (clio)

clio

>> setup termux

⭐ [SETUP WIZARD] Termux Setup

Run in your shell (exit Clio first):

clio-run-module termux_setup setup

>> exit

Step 2 — In your shell (after exit)

termux

$ clio-run-module termux_setup setup

Downloading termux_setup from registry…

🚀 Termux Complete Setup Wizard

✓ Wizard runs via bash (safe on Android)

Match labels in Clio

Clio shows a header so you know what kind of result you got

  • ⌨️ [SHELL COMMAND] — a single Linux command (e.g. ls, df -h). You can run it from the REPL menu after confirming.
  • ⭐ [SETUP WIZARD] — install/configure once (termux_setup, git_setup, …). Clio prints clio-run-module … setup — run that in your shell after exit.
  • 📦 [AUTOMATION MODULE] — repeatable task workflows. Download with download <id>, then run clio-run-module <id> setup in your shell.

💡 Why clio-run-module exists

Android's security layer blocks some syscalls inside Go binaries. The clio program handles natural-language lookup and module downloads; the separate clio-run-module bash script executes multi-step YAML workflows safely. Both are installed together:

curl -fsSL clipilot.themobileprof.com/clio | sh

inventory_2

50+

Ready-to-Use Modules

auto_fix_high

5

Setup Wizards

devices

3

Platforms (Linux, macOS, Android)

code

100%

Open Source

How Clio Works

Three layers: plain-English command lookup, one-time setup wizards, and repeatable automation modules

search

Plain English → Commands

Type what you want at the >> prompt. Clio matches your intent to shell commands from an offline catalog, local man pages, and cached modules — then asks before running.

auto_fix_high

Setup Wizards

Install & configure once. Five first-class wizards: Termux, Vim, Git, dev tools, and databases. Run setup or setup termux — modules download from this registry.

inventory_2

Automation Modules

Repeatable tasks. Copy files, check disk space, back up folders, and more. Browse with modules, download with download <id>, run via clio-run-module.

Ask in Plain English

Start Clio with clio, then type naturally at the >> prompt

⌨️ Shell commands

You ask: check disk space

Clio suggests: df -h — confirm before run

You ask: how do I find large files?

Clio suggests: find . -type f -size +100M

You ask: show hidden files with details

Clio suggests: ls -la

Setup Wizards vs Automation Modules

Both live in this registry — Clio separates them so you know what you're running

⭐ Setup Wizards 📦 Automation
WhenOnce / occasionallyWhenever needed
PurposeInstall & configureRepeat a task
Browse in Cliosetupmodules
Label[SETUP WIZARD][AUTOMATION]

Wizards: termux_setup, vim_setup, git_setup, devtools_setup, database_setup. See all with catalog.

Termux on Android

Module workflows always use clio-run-module in your shell — never inside the >> REPL

Android restricts syscalls inside Go binaries. Clio downloads modules from this registry; the clio-run-module bash script runs them safely outside the REPL.

First run on Termux:

  1. Install: curl -fsSL clipilot.themobileprof.com/clio | sh
  2. Run clio, then setup termux (or sync first if offline)
  3. Type exit to leave the REPL
  4. In shell: clio-run-module termux_setup setup

Lite profile on low-memory devices: sync fetches essentials only; use sync full for the complete catalog.

Troubleshooting: SIGSYS: bad system call means you tried to run a module workflow inside the REPL — exit Clio and use clio-run-module in your shell instead.

Install Clio from your terminal

Copy the command below, paste it into a terminal on Linux, macOS, or Android (Termux), and press Enter.

terminal Run in your terminal 
curl -fsSL clipilot.themobileprof.com/clio | sh
1

Open a terminal

Linux/macOS: Terminal or your preferred emulator. Android: Termux.

2

Paste and run the command

Copy the curl … | sh line above. The installer downloads Clio and adds it to your PATH.

3

Launch the REPL

Type clio — use setup termux on first run (Termux), then sync when online

4

Run module workflows in your shell

When Clio shows clio-run-module …, type exit first, then paste the command at the $ prompt