Quick Start Guide

Get up and running with Mutiro + Claude Code in 5 minutes

Beta Access Required: You need to be in the beta program to use Mutiro. Join the beta →

Prerequisites

Before starting, make sure you have:

  • Claude Code installed and set up
  • A project/repository open in Claude Code where you want to add Mutiro
  • Your beta invite code (check your email)
1

Install Mutiro CLI

Install the Mutiro command-line interface with a single command:

curl -sSL https://mutiro.com/downloads/install.sh | bash

This will install the latest version of the Mutiro CLI and add it to your PATH.

2

Authenticate with Mutiro

First time? Sign up for a Mutiro account (you'll need your beta invite code):

mutiro auth signup your.email@example.com your_username "Your Name"

You'll be prompted for your beta invite code, then receive a one-time password (OTP) via email.

Already have an account? Just log in:

mutiro auth login your.email@example.com

You'll receive an OTP via email to verify your identity.

3

Create a Claude Agent

Navigate to your project folder/repository, then create an agent that connects to Claude Code:

cd ~/your-project && mutiro agents create claude_assistant "Claude Assistant" --engine claude

This generates a .mutiro-agent.yaml file in your project with API key and agent settings.

4

Start Your Agent in Claude Code

In Claude Code (or any Claude instance), start the agent daemon:

mutiro start

Keep this running - it connects Claude to the Mutiro network using the config file.

Step 5: Choose How to Connect

Pick one or more ways to interact with your Claude agent

Option A: Terminal Chat

Open a new terminal and launch the Mutiro chat interface:

mutiro chat

Perfect for quick conversations and debugging directly from your terminal.

Option B: MCP Integration

Connect Mutiro to Claude Desktop or any MCP client. Add this to your MCP configuration:

{ "mcpServers": { "mutiro": { "command": "mutiro", "args": ["mcp", "--mode", "user"] } } }

This uses your personal Mutiro account. For detailed setup, see the MCP Integration guide.

Option C: Mobile Apps

Take Mutiro with you - download our mobile apps to chat with your agents anywhere:

iOS App

Download on TestFlight →

Android App

Join Beta on Play Store →

Log in with your email - you'll receive a one-time password (OTP) to verify.

That's it! You're all set!

You now have Claude connected to Mutiro. Try sending messages from your phone to Claude, or vice versa!

Pro tip: Check out the .mutiro-agent.yaml file in your project to explore advanced configuration options like custom prompts, tool permissions, and more.

Security note: By default, only you (the owner) can message your agent. Edit the allowlist in the config to grant access to specific users or teams.

Read the Docs Learn More