Mug

Skill mugwork/mug/.agents/skills/mug

Mug is an AI automation platform for building deployed agents, real code workflows, & headless web surfaces for everyday business, integrated with any API, and accessed via email, SMS, & Slack — all built locally using Claude Code, Codex, & Cursor.

Install

npx -y skills add mugwork/mug --skill mug

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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

SKILL.md

2.1 KB, as published. Nobody here has run it

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:

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:

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.

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.

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.