Skip to content
Mia

Quick Start

import { Steps, Tabs, TabItem } from ‘@astrojs/starlight/components’;

From Zero to Mobile AI Assistant

Section titled “From Zero to Mobile AI Assistant”

  1. Clone and build

    Terminal window
    git clone https://github.com/m1ab0t/mia.git ~/mia
    cd ~/mia && npm install && npm run build && npm link

  2. Run setup

    Terminal window
    mia setup

    Follow the prompts to pick your AI provider and authenticate.

  3. Start the daemon and pair your phone

    Terminal window
    mia start
    mia p2p qr

    Scan the QR code with the Mia mobile app. You’re connected — start chatting from your phone.

  4. Or use the CLI directly

    Terminal window
    mia chat

    Mia automatically detects your project, scans git state, and injects relevant context.

Common Workflows

Section titled “Common Workflows”

From Your Phone (Primary)

Section titled “From Your Phone (Primary)”

Once paired, the Mia mobile app gives you full control:

  • Chat — Send prompts, get streaming AI responses with full codebase context
  • Switch agents — Tap to switch between Claude Code, Gemini, Codex, OpenCode
  • Personas — Create custom AI personalities or generate them from a description
  • Scheduler — Create and monitor cron-based automated tasks
  • Slash commands — /standup, /doctor, /usage, /memory, /recap, and more

Interactive CLI Development

Section titled “Interactive CLI Development”
Terminal window
cd ~/my-project
mia chat

Inside the chat, use slash commands:

CommandWhat it does
/add src/api.tsInject a file into context
/exec npm testInject command output
/diffInject current git diff
/remember prefers pnpmSave a fact to memory
/newStart a fresh conversation

One-Shot Questions

Section titled “One-Shot Questions”
Terminal window
# Ask about the current project
mia ask "What does the auth middleware do?"


# Pipe in context
cat error.log | mia ask "What caused this crash?"


# Work on a specific directory
mia ask --cwd ~/other-project "Summarize this codebase"

AI Commit Messages

Section titled “AI Commit Messages”
Terminal window
# Stage some changes, then:
mia commit

Switch AI Providers

Section titled “Switch AI Providers”

From the mobile app, tap the plugin switcher. Or from CLI:

Terminal window
mia plugin list
mia plugin switch gemini
mia plugin test

Scheduled Tasks

Section titled “Scheduled Tasks”
Terminal window
# Morning standup every weekday at 9am
mia scheduler add "0 9 * * 1-5" "Write a standup report"


# Weekly changelog every Friday
mia scheduler add "0 17 * * 5" "Generate a changelog for this week"

Next Steps

Section titled “Next Steps”