codeceo 0.2.0

Phone the human when your AI coding assistant needs a decision. Thin client + MCP server for the CodeCEO service.

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

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

Set up (one time)

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):

{
  "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.