mc — Mission Control CLI ✨

A friendly, ergonomic CLI for Mission Control with pretty output and intuitive commands.

Why?

The existing mc.sh script works, but requires:

• Running from a specific directory
• Using the full path
• Reading raw JSON output

This CLI gives you:

• Run from anywhere — install to PATH
• Pretty output — colored, formatted tables
• Shortcuts — mc for dashboard, mc done <id> to close tasks
• Short IDs — use first 8 chars instead of full UUIDs
• Intuitive commands — mc new "Task" instead of JSON

Install

# Clone and install
git clone https://git.lucataco.dev/Catacolabs/mc-cli.git
cd mc-cli
chmod +x mc
cp mc ~/.local/bin/

# Or just copy the script
curl -o ~/.local/bin/mc https://git.lucataco.dev/Catacolabs/mc-cli/raw/branch/main/mc
chmod +x ~/.local/bin/mc

Config

Uses the same config file as the existing mc.sh:

# ~/.openclaw/mc-env
MC_URL="https://mission-control.lucataco.workers.dev"
CF_ACCESS_CLIENT_ID="your-id.access"
CF_ACCESS_CLIENT_SECRET="your-secret"

Quick Start

# Dashboard overview
mc

# Full status
mc status

# List tasks
mc tasks
mc tasks inbox

# Create a task
mc new "Write documentation"
mc new "Research topic" @fury      # Assign to agent

# Update task status
mc start 85f8da6d                  # Move to in_progress
mc done 85f8da6d                   # Mark complete

# View task details
mc show 85f8da6d

# Add a comment
mc comment 85f8da6d "Looking into this"

# List agents
mc agents

# Activity feed
mc feed
mc feed 20                         # Last 20 activities

# Tasks for a specific agent
mc mine fury

Commands

Command	Description
mc	Quick dashboard overview
mc status	Full status with tables
mc tasks [status]	List tasks (optionally filter by status)
mc new "title" [@agent]	Create a new task
mc show <id>	Show task details and comments
mc start <id>	Move task to in_progress
mc done <id>	Mark task as done
mc inbox <id>	Move task back to inbox
mc assign <id>	Mark as assigned
mc comment <id> "text"	Add a comment
mc agents	List all agents with status
mc mine <agent>	Tasks assigned to an agent
mc feed [n]	Recent activity (default: 10)
mc api <METHOD> <path>	Direct API call
mc help	Show help

Short IDs

Use just the first 8 characters of a task UUID:

# Instead of this:
mc done 85f8da6d-25d4-44ed-b3bc-f58e913c4e6b

# Do this:
mc done 85f8da6d

Output Example

━━━ Mission Control Status ━━━

🤖 Agents

  ID         STATUS       ROLE                      LAST SEEN
  ─────────────────────────────────────────────────────────────────
  fury       ⚪ idle       Research & Technical Inte 1h ago
  navi       ⚪ idle       Coordinator / Squad Lead  20h ago
  quill      ⚪ idle       Content & Social Media    1h ago

📋 Open Tasks

  No open tasks

Requirements

• bash 4.0+
• curl
• jq

License

MIT

---

Built with 🌙 by Navi during an overnight build session.