Setup Guide

This guide walks you through setting up the Mirra Claude Code Bridge on your computer.

Prerequisites

Before you begin, make sure you have:

Node.js 18+ installed (download)
Claude Code CLI installed and working
Mirra account — create one free at getmirra.app

Installation

Install the bridge globally via npm:

npm install -g mirra-cc-bridge

First run

Start the bridge with:

mirra-cc-bridge start

If this is your first time, the setup wizard will run automatically:

███╗   ███╗██╗██████╗ ██████╗  █████╗
████╗ ████║██║██╔══██╗██╔══██╗██╔══██╗
██╔████╔██║██║██████╔╝██████╔╝███████║
██║╚██╔╝██║██║██╔══██╗██╔══██╗██╔══██║
██║ ╚═╝ ██║██║██║  ██║██║  ██║██║  ██║
╚═╝     ╚═╝╚═╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝
       claude code bridge

Authenticating with Mirra...

  Opening browser...
  ✓ Browser opened

  Waiting for authorization...

Authenticate in browser

Your browser opens automatically to the Mirra sign-in page. Log in with your Mirra account and click Authorize to connect the bridge.

The CLI receives your credentials automatically — no copying API keys.

No browser? Use mirra-cc-bridge configure --manual to enter an API key directly.

Select destination chat

Choose which Mirra chat should receive Claude Code output. You can select an existing chat or create a new group.

Automatic configuration

The wizard automatically:

Configures Claude Code hooks — Sends notifications to Mirra when Claude needs input or completes tasks
Establishes Mirra Tunnel — Creates a secure connection between your PC and Mirra Cloud
Registers your PC — Makes your computer available as a Mirra resource for remote sessions

Once complete, you'll see:

  ✓ Authentication successful!
    Logged in as: you@example.com

[+] Configuration saved
    config: ~/.mirra/cc-bridge.json
    key:    mirra_abc1...xyz9
    dir:    /Users/you/projects
    group:  abc123def456...

[+] Hooks configured
[+] Mirra Tunnel connected
[+] PC registered as resource

> Bridge running. Waiting for sessions...
  Press Ctrl+C to stop

What gets configured

Claude Code hooks

The bridge adds hooks to ~/.claude/settings.json:

Notification hook — Fires when Claude has questions, needs approval, or completes work
Stop hook — Fires when a Claude Code session ends

These hooks send structured data to the Mirra app, including permission prompt cards and execution details.

Mirra Tunnel

The bridge establishes a secure tunnel to Mirra Cloud automatically. Unlike external tunnel services, Mirra Tunnel:

Requires no additional accounts or setup
Uses your Mirra API key for authentication
Reconnects automatically if the connection drops

Verify it works

With the bridge running, open the Mirra app on your phone
Go to the Extensions tab and check Active Tunnels — you should see your PC listed as connected
Start a conversation and ask Mirra to run a Claude Code task:

"Start a Claude Code session to check what files are in my project"
Claude's output will appear in the chat with rich execution cards

Commands reference

Command	Description
`mirra-cc-bridge start`	Start the bridge (runs setup if needed)
`mirra-cc-bridge setup`	Re-run the setup wizard
`mirra-cc-bridge configure`	Configure API key and settings
`mirra-cc-bridge configure --manual`	Use manual API key entry instead of browser auth
`mirra-cc-bridge status`	Show current configuration and connection status
`mirra-cc-bridge config`	Display configuration details

Configuration file

The bridge stores its configuration in ~/.mirra/cc-bridge.json:

{
  "apiKey": "mirra_...",
  "userId": "user_abc123",
  "groupId": "group_xyz789",
  "defaultWorkDir": "/Users/you/projects",
  "hooksConfigured": true,
  "setupComplete": true
}