# Mira Server

> The user invoked `/mira-server` with an optional argument. Parse the argument (default to `status` if none given) and run the corresponding operation below. Run the commands exactly as shown — do not paraphrase or ask for confirmation.

- Skill: `mabaeyens/mira-server` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mabaeyens/mira-server`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mabaeyens/mira-server/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: mabaeyens (https://skillmd.com/u/mabaeyens)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mabaeyens/mira-server

---


The user invoked `/mira-server` with an optional argument. Parse the argument (default to `status` if none given) and run the corresponding operation below. Run the commands exactly as shown — do not paraphrase or ask for confirmation.

## Paths

- Plist source: `~/Projects/mira-core/com.mab.mira.plist`
- Plist target: `~/Library/LaunchAgents/com.mab.mira.plist`
- Service label: `com.mab.mira`
- Log file: `/tmp/com.mab.mira.log`
- Health endpoint: `http://localhost:8000/health`

## Operations

### start
Load the LaunchAgent (plist must already be in `~/Library/LaunchAgents/`).
```bash
launchctl load ~/Library/LaunchAgents/com.mab.mira.plist
```
Then run the `status` check.

### stop
Unload the LaunchAgent, stopping the server.
```bash
launchctl unload ~/Library/LaunchAgents/com.mab.mira.plist
```
Then run the `status` check.

### install
First-time setup. Copies the plist and loads the agent.
```bash
cp ~/Projects/mira-core/com.mab.mira.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.mab.mira.plist
```
Then run the `status` check.

### reload
Use after any change to server.py or the plist. Unloads, re-copies, reloads.
```bash
launchctl unload ~/Library/LaunchAgents/com.mab.mira.plist
cp ~/Projects/mira-core/com.mab.mira.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.mab.mira.plist
```
Then run the `status` check.

### restart
Kick the running agent without touching the plist.
```bash
launchctl kickstart -k "gui/$(id -u)/com.mab.mira"
```
Then run the `status` check.

### logs
Show the last 40 lines of the log and any errors or exceptions at a glance.
```bash
tail -40 /tmp/com.mab.mira.log 2>/dev/null || echo "no log file yet"
```
Highlight any lines containing ERROR, Exception, Traceback, or Warning.

### status (default)
Run these two commands in parallel:
```bash
pgrep -a python 2>/dev/null | grep server.py || echo "server.py: not running"
```
```bash
curl -s --max-time 2 http://localhost:8000/health 2>/dev/null || echo "health: unreachable"
```
Report concisely: process running (PID), health response, and whether the LaunchAgent plist exists in `~/Library/LaunchAgents/`.