Skip to content
Development
Command

/smoke-test

Use after making changes to amux-server.py to verify the dashboard and APIs are working correctly

From plugin
amux
33510 skills10 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 amux-server.py 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}' https://localhost:8822/ | grep -q 200

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

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

# 4. Board API responds
curl -sk https://localhost:8822/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 https://localhost:8822/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 https://localhost:8822/api/notes | python3 -c "import json,sys; json.load(sys.stdin); print('notes ok')"

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

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

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

# 11. Calendar feed
curl -sk https://localhost:8822/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, monitor & orchestrate dozens of parallel Claude Code, Codex & Gemini sessions from one web dashboard or your phone. Self-healing, single-file, tmux-native.

Get the whole plugin