Metadata-Version: 2.4
Name: codeceo
Version: 0.3.0
Summary: Phone the human when your AI coding assistant needs a decision. Thin client + MCP server for the CodeCEO service.
Project-URL: Homepage, https://github.com/GQChem/codeceo-client
Author: CodeCEO
License: MIT
Keywords: ai,claude,coding-assistant,mcp,notifications
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.2
Requires-Dist: qrcode[pil]>=7.4
Description-Content-Type: text/markdown

# CodeCEO

**Get a phone call when your AI coding assistant needs a decision.** A voice reads its update, you answer out loud, and your spoken reply goes back to the assistant as text — so you can step away from long autonomous runs without it guessing.

This package is the **client + MCP server**. It talks to the hosted CodeCEO service; you also install the **CodeCEO Android app** to receive the calls.

## Install

```bash
pipx install codeceo      # recommended (isolated, puts `codeceo` on PATH)
# or: pip install codeceo
```

## Set up — one command

```bash
codeceo setup
```

This creates your account, wires CodeCEO into **Claude Code** (user scope — every project), and shows a QR to pair your phone in the CodeCEO Android app. Then restart Claude Code and run `codeceo test` to confirm.

- Other assistant? `codeceo install --assistant codex` prints the MCP snippet to paste.
- Manual: `codeceo signup` → `codeceo install` → `codeceo connect`.

Get the Android app and the full guide here: **https://github.com/GQChem/codeceo-client**

Your assistant then uses `set_assistant(name, project)` once, and `call_ceo(summary, input_needed)` to ring you and wait for your answer.
