# Mirra Claude Code Bridge

Bridge Claude Code to your Mirra mobile app for remote coding sessions. Control your local Claude Code sessions from your phone via text messages and voice calls.

## Features

- **Remote Control** — Start and manage Claude Code sessions from your phone
- **Permission Prompts** — Approve or deny tool usage with a single tap
- **Execution Details** — See what Claude did with step-by-step cards
- **Multi-turn Conversations** — Send follow-up prompts naturally
- **Secure Tunnel** — No ngrok or port forwarding needed

## Quick Start

```bash
npm install -g mirra-cc-bridge
mirra-cc-bridge
```

The setup wizard handles everything automatically. Your browser will open for a quick sign-in — no API keys to copy.

## Requirements

- Node.js 18+
- Claude Code CLI installed
- Mirra account ([getmirra.app](https://getmirra.app))

## Commands

| Command | Description |
|---------|-------------|
| `mirra-cc-bridge` | Start the bridge (runs setup if needed) |
| `mirra-cc-bridge configure` | Configure API key and settings |
| `mirra-cc-bridge status` | Show bridge status |
| `mirra-cc-bridge config` | Show current configuration |

## How It Works

```
Your Phone  ◄───►  Mirra Cloud  ◄───►  Your PC (Claude Code)
```

1. The bridge connects your PC to Mirra via secure WebSocket tunnel
2. Send prompts from the Mirra app to start Claude Code
3. Claude's output appears as rich cards on your phone
4. Tap Allow/Deny for permission prompts
5. Reply to continue the conversation

## Documentation

For detailed setup instructions, troubleshooting, and advanced usage:

**[docs.getmirra.app/docs/claude-code](https://docs.getmirra.app/docs/claude-code)**

### Additional Resources

- [Setup Guide](https://docs.getmirra.app/docs/claude-code/setup) — Step-by-step installation
- [Remote Control](https://docs.getmirra.app/docs/claude-code/remote-control) — Using from your phone
- [How It Works](https://docs.getmirra.app/docs/claude-code/how-it-works) — Technical architecture
- [Tunnels](https://docs.getmirra.app/docs/tunnels) — Building custom tunnel clients

## License

MIT