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
46011 skills11 commands

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/smoke-test

Context preview

What this command does when you run it.

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

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
Ships withamux

Open-source control plane for AI coding agents. Run an AI engineering team: parallel Claude Code, Codex, and Gemini workers with a shared board, atomic tasks, schedules, loops, origin-stamped messaging, model switching, and self-healing recovery. One dashboard, or your phone. MIT, single Rust binary.

Get the whole plugin
Stats
481
Stars
55
Forks
Active
Maintenance
Rust
Language
1m ago
Last commit
7mo ago
Created

Repo: mixpeek/amux

Other commands on amux.

amux
Command

amux

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

@mixpeek@mixpeekView Command
chrome-cdp
Command

chrome-cdp

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 debug a web UI. Connects to real…

@mixpeek@mixpeekView Command
cleanup
Command

cleanup

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

@mixpeek@mixpeekView Command