Everything you need to know about using dotty — your AI coding agent that calls you when it needs help.
Sign up at dotty.dev/login using your email. We'll send you a magic link — no password needed.
npm install -g @dotty/dotty
dotty setup
This will guide you through linking your account, setting your phone number, and configuring your API key.
Go to Settings > API Keys and add your Anthropic, OpenRouter, or OpenAI API key. This powers the AI voice conversations.
In Settings > Phone & PIN, set a 4-digit PIN. You'll need this to authenticate when calling dotty.
dotty start
This starts a session that monitors your Claude Code agent. When the agent gets stuck, dotty calls you so you can talk through it.
dotty can call you when your coding agent needs input, or you can call dotty to check on your sessions.
When your agent hits a blocker or completes a task, dotty calls your registered phone number. You'll hear a summary of what happened and can give instructions by voice.
Call your dedicated dotty number (or the shared number on the free tier) at any time. Enter your 4-digit PIN, then ask about your sessions or give instructions.
Free tier: Use the shared number. PIN required.
Pro/BYOK tier: Get a dedicated number. PIN required for phone, not for WhatsApp.
Pro and BYOK users can also call dotty via WhatsApp. WhatsApp calls are verified by your account, so no PIN is needed. WhatsApp calls are free and don't count against your monthly minutes.
When on a call with dotty, you can speak naturally. Here are some things you can say:
"What are my active sessions?"Get a summary of all running agent sessions
"What's happening on the dotty project?"Status update for a specific project
"Tell the agent to try a different approach"Send instructions to a blocked agent
"Resume the last session"Unblock a waiting agent with your input
"How many minutes have I used?"Check your usage for the current period
"Call me back in 30 minutes"Schedule a callback
"Send me a text summary"Get an SMS with session details
dotty setup
Interactive setup wizard — links your account and configures settings
dotty start
Start a new agent session in the current directory. Monitors your Claude Code agent and connects it to dotty.
dotty start --resume <token>
Resume a previous session using a resume token
dotty sync
Sync your local settings with the server
dotty usage
Check your current usage and remaining minutes
dotty byok
Configure Bring Your Own Key settings
$0
$20/mo
$20/mo
dotty is a phone-based interface for your AI coding agents. When your agent gets stuck or finishes a task, dotty calls you so you can give instructions by voice instead of switching context to your terminal.
dotty supports Anthropic (Claude), OpenAI, and OpenRouter. You bring your own API key.
Yes. Your API key is encrypted at rest and only used when making AI calls on your behalf. It is never exposed in logs or to other users.
Yes! You can use SMS-only mode or WhatsApp. Set your notification preferences in Settings.
During quiet hours, notifications are held and delivered when the quiet hours period ends. Urgent blockers can still reach you if configured.
Yes! Free tier supports 1 machine. Pro supports 5. BYOK supports unlimited. Each machine runs an independent agent session.
Save the dotty WhatsApp number in your contacts and call via WhatsApp. Your WhatsApp account verifies your identity, so no PIN is needed. WhatsApp calls are free.