/ getting started

Run your CLI agents from your phone.

Cici is a tiny menu bar app on your Mac plus a phone PWA. It mirrors any tmux session running a CLI agent (Claude Code, Codex, Gemini, your own scripts) to your phone, so you can approve, prompt, or cancel from anywhere.

view raw ↗
01Install

Install

On your Mac, run the installer. It downloads the signed app, drops it in /Applications, opens it, and installs the cici terminal command.

Requires macOS 13+. If you don’t have tmux, install it with brew install tmux.

02Start a session

Start a session

Open a terminal and start a named tmux session for your agent. The name is just a label — it shows up as a tab in the PWA.

That drops you into tmux. Launch your agent inside it the way you normally would:

$ claude          # or codex, gemini, aider, your own script

Already running tmux? Cici picks those sessions up automatically — no rename required.

03Pair your phone

Pair your phone

Click the Cici icon in your menu bar and open the Pairing tab.

  1. Scan the QR code with your iPhone Camera.
  2. Tap the link, then add the page to your Home Screen.
  3. Open it from the Home Screen and tap Enable Alerts.

That’s it — your phone is now paired and will buzz the moment an agent stops to ask you something.

04Control from anywhere

Control from anywhere

When an agent waits for input, you’ll get a Web Push. Open the PWA and you’ll see the live terminal pane with three default buttons:

  • Approve — sends 1 +
  • Always — sends 2 +
  • Cancel — sends ⌃C

You can also type a free-form prompt at the bottom to nudge the agent. Tabs at the top let you flip between sessions.

05Everyday commands

Everyday commands

$ cici start <name>   # start (or attach to) a named tmux session
$ cici list           # show running sessions Cici can see
$ cici stop <name>    # kill a session

All of this is just standard tmux underneath — you can also use tmux ls, tmux attach -t <name>, etc.

06Updates & uninstalling

Updates & uninstalling

The Mac app updates itself in the background via Sparkle. You don’t need to re-run npx @getcici/setup after the first install.

To uninstall: quit Cici from the menu bar, drag /Applications/Cici.app to the Trash, and remove the CLI shim with rm ~/.local/bin/cici.

need help?

Cici is in private beta. If something breaks or feels weird, email hello@getcici.com with what you tried and what happened.