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.
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.
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.
Pair your phone
Click the Cici icon in your menu bar and open the Pairing tab.
- Scan the QR code with your iPhone Camera.
- Tap the link, then add the page to your Home Screen.
- 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.
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.
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.
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.
Cici is in private beta. If something breaks or feels weird, email hello@getcici.com with what you tried and what happened.