← Back to Suitcase Update & Smoke Tests

Update Suitcase & Run the Smoke Tests

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.

Agent update prompt
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.