---
name: mosaic-macp
description: Manage MACP tasks — submit, check status, view history, and drain queues. Use when orchestrating coding tasks via the Mosaic Agent Coordination Protocol.
---

# macp

MACP task management via the mosaic CLI.

## Setup

Ensure PATH includes mosaic bin:

```bash
export PATH="$HOME/.config/mosaic/bin:$PATH"
```

## Commands

| Command                                                                       | Purpose                                                        |
| ----------------------------------------------------------------------------- | -------------------------------------------------------------- |
| `mosaic macp status`                                                          | Show queue counts (pending/running/completed/failed/escalated) |
| `mosaic macp submit --task-id ID --title "..." --type coding --command "..."` | Submit a task                                                  |
| `mosaic macp history --task-id ID`                                            | Show event history for a task                                  |
| `mosaic macp drain`                                                           | Run all pending tasks sequentially                             |
| `mosaic macp watch --once`                                                    | Poll events once                                               |

## Common Workflows

**Check what's in the queue:**

```bash
export PATH="$HOME/.config/mosaic/bin:$PATH"
mosaic macp status
```

**Submit a coding task:**

```bash
mosaic macp submit --task-id TASK-001 --title "Fix auth bug" --type coding --command "echo done"
```

**View task history:**

```bash
mosaic macp history --task-id TASK-001
```
