Metadata-Version: 2.4
Name: codeceo
Version: 0.2.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 time)

```bash
codeceo signup            # creates your account, prints your API key
export CODECEO_API_KEY=cco_...   # (PowerShell: $env:CODECEO_API_KEY="cco_...")
codeceo connect           # shows a QR — scan it in the CodeCEO Android app to pair
codeceo test              # rings your phone to confirm it works
```

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

## Connect to your AI assistant

Add to your assistant's MCP config (e.g. Claude Code `.mcp.json`):

```json
{
  "mcpServers": {
    "codeceo": {
      "command": "codeceo",
      "args": ["serve"],
      "env": { "CODECEO_API_KEY": "cco_..." }
    }
  }
}
```

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