# Mug

> Run Mug CLI developer workflow commands — dev server, update, deploy, clone, shutdown, workspaces.

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

---


# Mug CLI

Run a Mug developer workflow command.

## Input

Command: `$ARGUMENTS`

## Dispatch

Run the matching CLI command in the workspace root:

- `dev` → see **Dev Server** below
- `shutdown` → see **Shutdown** below
- `update` → `mug update` (forces full refresh — normally auto-runs every 4h)
- `deploy` → `mug deploy`
- `clone` → see **Clone** below
- `workspaces` → `mug workspaces`

If no argument or unrecognized argument, show available commands and ask which to run.

## Dev Server

The dev server **hot-reloads** file changes automatically — editing connectors, workflows, agents, surfaces, or config files takes effect immediately without a restart. Only restart after a CLI update (`mug update`).

Check if a dev server is already running by looking for the PID file:

```bash
cat .mug/dev.pid 2>/dev/null
```

If a dev server is already running, you're done — it will pick up your changes. Only start a new one if no server is running:

```bash
mug dev
```

Run this command **in the background** — it's a long-running process.

Options:
- `mug dev --port <port>` — pin to a specific port (default: auto-detect from 8787)
- `mug dev --tunnel` — expose via Cloudflare Quick Tunnel (requires `cloudflared` installed)

The dev server auto-detects free ports, so multiple workspaces can run simultaneously.

## Shutdown

Gracefully stop the running dev server. Writes back database changes and cleans up.

```bash
mug shutdown
```

This reads `.mug/dev.pid` and sends SIGTERM to the dev server process.

## Clone

Clone an existing workspace from Mug cloud to the local machine. Creates a new directory, scaffolds workspace structure, and connects it to the cloud workspace.

```bash
mug clone                 # shows workspace picker if you have multiple
mug clone acme            # clone by name, subdomain, or ID
```

Files and databases stay remote — use `mug pull --all` to download locally if needed. Requires `mug login` first.