# Paigy

> Paigy is the AI agent harness that calls your phone. Run Claude Code, OpenAI Codex, Google Antigravity, or any MCP-compatible agent in your terminal; hand off the work, and your phone rings — a native incoming call — when an agent needs a decision or finishes a job. Answer by voice and the agent resumes. Free; iOS app plus an MCP server and machine harness.

Install: `curl -fsSL https://paigy.ai/install | sh` (one command, one QR scan). The MCP server is `@paigy/mcp` on npm; the machine harness is `@paigy/harness` (`paigy-harness setup`).

## Docs

- [About Paigy](https://paigy.ai/about): what it is, how calls work, engagement modes, install for Claude Code, Codex, Antigravity, and other MCP clients
- [Connect Paigy to Claude, ChatGPT or Gemini](https://paigy.ai/docs/connect-your-assistant): add the hosted MCP server `https://paigy.ai/api/mcp` as a custom connector (Claude), custom MCP server (ChatGPT) or custom app (Gemini); sign-in is one approval on paigy.ai/connect. The chat app can call Paigy while you chat; Paigy cannot wake it. ChatGPT was confirmed on a real account on 2026-10-28; the Gemini steps are new and not yet confirmed
- [Tutorial: connect Claude](https://paigy.ai/docs/connect-claude): connect, then have Claude put a question on your phone and read your answer back
- [Tutorial: connect ChatGPT](https://paigy.ai/docs/connect-chatgpt): the same first task in ChatGPT (developer mode / custom MCP server)
- [Tutorial: connect Gemini](https://paigy.ai/docs/connect-gemini): the same first task in the Gemini app (custom app)
- [Get a phone call when Claude Code needs approval](https://paigy.ai/docs/claude-code-phone-approvals): ring your phone when an agent is blocked on a decision; answer by voice and it resumes
- [A quiet inbox for AI agent notifications](https://paigy.ai/docs/quiet-inbox): agent updates settle silently in one inbox; only what's worth a ring becomes one
- [Separate identities for Claude, Codex and Antigravity](https://paigy.ai/docs/multi-agent-identities): per-agent identity slots, voices, and reach limits from one setup command
- [Run coding agents without keeping a terminal open](https://paigy.ai/docs/background-sessions): a host service lets your phone start and steer headless agent sessions
- [Answer your agent's questions from your phone](https://paigy.ai/docs/answer-from-your-phone): structured answers — confirm, pick-one, multi-select, rank — plus images and sandboxed HTML previews
- [Let someone else make a decision your AI agent is waiting on](https://paigy.ai/docs/let-someone-else-decide): Phone a friend — forward an agent's one-choice or yes/no question by link, or a report to read; they answer without an account, by a pick or in their own words, and the agent carries on, told who decided
- [Never lose a long-running agent job](https://paigy.ai/docs/long-running-jobs): each job is a Goal the agent owns — progress via contact updates, a follow-up time via manage_goals defer that wakes the agent, and contact to reach your phone
- [Decide when an AI agent may ring you](https://paigy.ai/docs/call-modes): Default / LockedIn / DateNight modes, per-agent limits, configurable retry schedule
- [Voice AI without background listening](https://paigy.ai/docs/private-by-design): the mic is live only while you're on a call or recording a voice note; content stays private to your account

## Optional

- [Privacy policy](https://paigy.ai/privacy)
- [Terms](https://paigy.ai/terms)
- [Support](https://paigy.ai/support)
- [GitHub](https://github.com/paigy-ai/mcp)
- [npm: @paigy/mcp](https://www.npmjs.com/package/@paigy/mcp)