# Cici Docs

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.

## 1. Install

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

```bash
npx @getcici/setup
```

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

## 2. 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.

```bash
cici start claude
```

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

```bash
claude          # or codex, gemini, aider, your own script
```

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

## 3. 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.

## 4. 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` + Enter
- **Always** — sends `2` + Enter
- **Cancel** — sends Ctrl+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.

## 5. Everyday commands

```bash
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.

## 6. 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`.

## Help

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