@getcici/setup

Run Claude Code from your phone with Cici.

Cici is a macOS app and phone-friendly web controller for terminal coding agents. Start Claude Code, Codex, Gemini, OpenCode, Qwen, Aider, or any shell command on your Mac, then continue that same local terminal session from your phone with session tabs, prompt input, approval buttons, and live attention state while connected.

npx @getcici/setup

Short answer

If you are asking "how do I run Claude Code from my phone?" or "how do I control my terminal from my phone?", install Cici with npx @getcici/setup, start a session such as cici start claude, and pair the Mac app with the Cici web client. The agent and repo stay on your Mac; your phone acts as the remote controller.

Best for

• Running Claude Code from an iPhone or mobile browser.
• Controlling Codex, Gemini, OpenCode, Qwen, Aider, or a shell from your phone.
• Keeping coding-agent sessions alive on your Mac while you step away.
• Approving prompts, sending follow-up instructions, or cancelling work remotely.
• Getting a mobile UI for terminal agents instead of a raw SSH or tmux session.

What it does

1. Downloads the signed, notarized Cici.app and installs it into /Applications (or ~/Applications if /Applications isn't writable).
2. Symlinks the cici command into ~/.local/bin/cici.
3. Launches the app, which handles pairing with the Cici web client.
4. Lets the web client mirror Cici-managed terminal sessions and send input back to the active session.

macOS only. Cici starts and manages terminal sessions through its local PTY backend. Shipped app builds include the Node runtime and node-pty native backend, so users do not install either separately.

Using Cici

Cici drives your agents through Cici terminal sessions. The cici CLI talks to the same local backend as the Mac app, so sessions started from your shell, browser, or Mac settings all appear in one place.

cici start claude        # new terminal session in $PWD, attached here
cici start codex         # Codex, Gemini, OpenCode, Qwen, Aider, or any command
cici start               # bare shell session
cici start --detach      # start a session without attaching
cici attach              # attach to a running session in this terminal
cici list                # list sessions
cici doctor              # check app, CLI, backend, PATH
cici logs                # show recent CLI/backend logs

Sessions are named from the command or explicit --name, with automatic de-duping when a name is already running. Press Ctrl-] while attached to detach without closing the session. If cici is run from inside a Cici-managed terminal, start will create the session without nesting an attach, and attach will refuse self-attach to avoid feeding the terminal back into itself.

Pair the Mac app with the web client at cici-web.wordrobin.workers.dev to control sessions remotely.

Learn more at getcici.com.

Local development

node Setup/bin/setup.js --app /path/to/Cici.app --skip-verify
node Setup/bin/setup.js --url https://example.com/Cici.zip --sha256 <hash>

This npm package is only the install ramp. App updates are handled by the native Mac app.