# Remoko — Overview & Quickstart

> Remoko is a remote control for your coding agents. It connects any MCP-capable agent to your iPhone and turns a blocking terminal prompt into a structured decision: risk level, consequences, recommendation. Answer in one tap and work resumes.

Canonical HTML page: https://remoko.app/docs

## What Remoko is

Agents rarely fail outright — they stall, waiting on a permission prompt or an ambiguous fork, silently, at a terminal nobody is looking at. Remoko moves *only the decisions* to your phone, not your workstation.

Remoko is:
- **Not a remote desktop.** No screen mirroring, no terminal, no typing code on a phone.
- **Not a chat client.** You do not converse with the agent. You answer it.
- **Not an agent.** Remoko never decides, never suggests-and-defaults, never acts.

"Remoko is not a terminal on your phone. It's a doorbell."

## How to get it

1. **Download the iOS app** (free, beta): https://testflight.apple.com/join/uSRmabxx (requires Apple's TestFlight app)
2. **Sign in** with your phone number and verify with the SMS code. No passwords; no email address required.
3. **Allow notifications** — Remoko relies on Apple Push Notifications to alert you to pending decisions.

## How to connect an agent

1. Open the **Connect** tab in the Remoko iOS app.
2. Copy your unique **MCP Endpoint URL** and **Access Token**.
3. Configure your agent client (Claude Code, Codex, Cursor, or any MCP client) to connect to that remote MCP server, sending the token on every request:

```
Authorization: Bearer remoko_tok_...
```

4. Have the agent call the `how_to_use` tool first — it returns the full reliability contract (idempotency, versioning, processed acknowledgments).

## What agents can do

| Tool intent | Description |
|---|---|
| Ask a question | Pose a question with optional predefined choices or free-text answers |
| Request approval | Propose an action with a risk level and wait for approve/deny |
| Send a check-in | Inform the owner of something; no response required |
| Update / cancel | Modify or cancel an existing request when it's no longer relevant |
| Report execution | Flow execution status (executing/completed/failed) back to the app |
| List unprocessed | Recover pending decisions after an agent restart |

Full reference: https://remoko.app/docs/mcp-tools.md

## Pricing

Remoko is free during the beta.

## More

- Security model: https://remoko.app/docs/security.md
- FAQ: https://remoko.app/docs/faq.md
- Brand & press kit (free assets): https://remoko.app/docs/brand.md
- Machine index: https://remoko.app/llms.txt