Already have Suitcase installed? Hand this prompt to your agent to update the installed command to v2.3.0 and run all the smoke tests — the runtime diagnostics and a full agent UI round-trip.
Update the installed Suitcase command and run all the smoke tests.
1. Update the installed package
- Download the latest signed and notarised installer package:
curl -fL https://suitcase.richardstelling.com/download/current.pkg -o Suitcase-v2.3.0-macos.pkg
- Reinstall over the existing copy with macOS Installer. This may ask for the
administrator password and replaces the binary at /usr/local/bin/Suitcase:
sudo /usr/sbin/installer -pkg ./Suitcase-v2.3.0-macos.pkg -target /
- Refresh the embedded suitcase-agent-ui skill so it matches the new version:
/usr/local/bin/Suitcase install-ui-skill
2. Confirm the update landed
- Confirm the updated version (expect 2.3.0):
/usr/local/bin/Suitcase --version
- Confirm the skill is installed and up to date:
/usr/local/bin/Suitcase check-ui-skill
3. Run all the smoke tests
- Runtime diagnostics smoke test (must report a healthy runtime):
/usr/local/bin/Suitcase diagnostic --json
- Agent UI round-trip: using the suitcase-agent-ui skill, create a minimal
throwaway session (pipe a minimal AgentUIRequest on stdin), wait for its
result, then close it. Take the sessionID from the create JSON envelope:
/usr/local/bin/Suitcase agent-ui create
/usr/local/bin/Suitcase agent-ui wait <sessionID>
/usr/local/bin/Suitcase agent-ui close <sessionID>
4. Report the result
- Only if `/usr/local/bin/Suitcase --version` printed 2.3.0, check-ui-skill
reported the skill is up to date, diagnostic reported a healthy runtime, AND
the agent-ui round-trip succeeded, open a native confirmation window:
/usr/local/bin/Suitcase utility \
--application-identifier "$(uuidgen)" \
--name "Suitcase Smoke Tests" \
--window-title "Suitcase Smoke Tests" \
--window-width 520 --window-height 280 --window-floating \
--control-type label \
--control-title "suitcase updated — smoke tests passed" \
--control-type text \
--control-title "Updated to 2.3.0; diagnostics healthy and the agent-ui round-trip succeeded." \
--control-type button --control-title "Quit" --control-action ":quit"
- If any check fails, do NOT open the window — report exactly what failed instead.