Skip to content
Development
Command

/smoke-test

Use after making changes to the amux server or dashboard to verify the dashboard and APIs are working correctly

From plugin
amux
55711 skills11 commands

Command definition

smoke-test.md
description: Use after making changes to the amux server or dashboard to verify the dashboard and APIs are working correctly
allowed-tools: Bash, Read
argument-hint: [quick|full]
context: fork

/smoke-test — Product Verification

Quick health check of the amux server and dashboard after code changes.

The user's request is: **$ARGUMENTS**

Quick (default)

Run these checks and report pass/fail for each:

# 1. Server is up
curl -sk -o /dev/null -w '%{http_code}' $AMUX_URL/ | grep -q 200

# 2. Dashboard HTML is valid (contains expected markers)
curl -sk $AMUX_URL/ | grep -q 'id="app"'

# 3. Sessions API responds
curl -sk $AMUX_URL/api/sessions | python3 -c "import json,sys; d=json.load(sys.stdin); print(f'{len(d)} sessions')"

# 4. Board API responds
curl -sk $AMUX_URL/api/board | python3 -c "import json,sys; d=json.load(sys.stdin); print(f'{len(d)} items')"

# 5. SSE endpoint connects (grab first event within 15s)
timeout 15 curl -sk -N $AMUX_URL/api/events 2>/dev/null | head -5

# 6. Workspace compiles + client JS parses
cargo check --workspace --quiet && echo "cargo check ok"
node --check crates/amux-dashboard/static/app.js && echo "client JS ok"

Full

Run all quick checks plus:

# 7. Notes API
curl -sk $AMUX_URL/api/notes | python3 -c "import json,sys; json.load(sys.stdin); print('notes ok')"

# 8. Schedules API
curl -sk $AMUX_URL/api/schedules | python3 -c "import json,sys; json.load(sys.stdin); print('schedules ok')"

# 9. CRM API
curl -sk $AMUX_URL/api/crm/contacts | python3 -c "import json,sys; json.load(sys.stdin); print('crm ok')"

# 10. Email inbox API
curl -sk "$AMUX_URL/api/email/inbox?count=1" | python3 -c "import json,sys; json.load(sys.stdin); print('email ok')"

# 11. Calendar feed
curl -sk $AMUX_URL/api/calendar.ics | head -1 | grep -q 'BEGIN:VCALENDAR' && echo "ical ok"

Report a summary table: check name, status (pass/fail), and any error details for failures.

Gotchas

  • Always use `curl -sk` — self-signed TLS cert.
  • The SSE check may hang if the server is down — the `timeout` command handles this.
  • A syntax check pass does not mean the server reloaded — it auto-restarts on file save, but if the save was recent, give it 1-2 seconds.
Read more
@mixpeek
Ships withamux

The agent control plane: run Claude Code, Codex and Gemini CLI agents in parallel with a shared task board, schedules and usage-limit recovery. Native iPhone, iPad and Mac apps plus a web dashboard. Self-host (Rust + SQLite, Tailscale remote access) or use amux Cloud. MIT + Commons Clause.

Stars on GitHub

Momentum

stars in total
557
Star history of mixpeek/amux on GitHub, a chart by star-history.com

Other commands on amux.

aissue

aissue

Command

Pick up an open issue from the amux issue tracker, mark it doing, work it, and mark it done.

@mixpeek@mixpeekInstall Command
amux-board

amux-board

Command

Use when the user says "add to board", "create a task", or wants to track a todo on the amux kanban board

@mixpeek@mixpeekInstall Command
amux

amux

Command

Use when you need to interact with the amux system — manage board tasks, check sessions/workers, send emails, message via…

@mixpeek@mixpeekInstall Command
bad-guy

bad-guy

Command

Before shipping, play the bad guy: run a fixed checklist of 14 attacks against your OWN app with test accounts and test data,…

@mixpeek@mixpeekInstall Command
chrome-cdp

chrome-cdp

Command

Use when the user asks to interact with a web page, take a screenshot of a site, click or type in Chrome, scrape content, or…

@mixpeek@mixpeekInstall Command
cleanup

cleanup

Command

Repo/branch/file hygiene sweep — stray artifacts, doc drift, stale branches, worktrees, upstream sync, backup sprawl, duplicate…

@mixpeek@mixpeekInstall Command

More commands from other plugins.

build
Auto-invoked

build

Command

Implement tasks incrementally — build, test, verify, commit. Add "auto" to run the whole plan in one approved pass.

@addyosmani@addyosmaniInstall Command