# Mug

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

- **Type:** Skill
- **Install:** `agentstack add skill-mugwork-mug-mug`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [mugwork](https://agentstack.voostack.com/s/mugwork)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [mugwork](https://github.com/mugwork)
- **Source:** https://github.com/mugwork/mug/tree/main/.claude/skills/mug
- **Website:** https://mug.work

## Install

```sh
agentstack add skill-mugwork-mug-mug
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 ` — 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.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [mugwork](https://github.com/mugwork)
- **Source:** [mugwork/mug](https://github.com/mugwork/mug)
- **License:** MIT
- **Homepage:** https://mug.work

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-mugwork-mug-mug
- Seller: https://agentstack.voostack.com/s/mugwork
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.