📋 Shared Instructions: shared-instructions.md — Cross-cutting concerns.

Play

Opens a Microsoft App in the browser by fetching its cloud play URL and launching it. No local dev server required.

Live vs. preview: Live requires a prior ms app deploy. Preview builds from source on demand — it works without any deployment and always reflects unpublished code.

Workflow

1. Memory Bank → 2. Verify Project + Env → 3. Resolve Mode → 4. Run → 5. Surface URL

Step 1: Check Memory Bank

Read memory-bank.md per shared-instructions.md for the app's environment/app identifiers, if recorded.

Step 2: Verify Project + Env

test -f ms.config.json || { echo "Not in a Microsoft App workspace."; exit 1; }
BIN=ms
$BIN auth status                                         # must report the expected UPN

--app and --environment-id can be passed explicitly to run from outside a project directory — ms.config.json is only needed for the defaults.

Step 3: Resolve Mode

If not already clear from the user's request, ask:

"Do you want to open the live deployed version, a preview of the latest code on main, or a preview of a specific commit?"

Map intent to mode:

Step 4: Run

Live (default):

$BIN app play

Preview — latest code on main:

$BIN app play --mode preview

Preview — specific commit:

$BIN app play --mode preview --commit <sha>

Full flag reference:

Step 5: Surface URL

Present the URL the CLI printed. For live mode, surface the CLI's built-in warning:

Live URL for 'my-app':
  https://apps.powerapps.com/play/e/<env-id>/app/<guid>

⚠ Live does not auto-update. Run /deploy to publish new code to the live URL.

For preview:

Preview URL for 'my-app' (main):
  https://apps.powerapps.com/play/e/<env-id>/app/<guid>/branch/main

For commit-pinned preview:

Preview URL for 'my-app' (commit abc1234):
  https://apps.powerapps.com/play/e/<env-id>/app/<guid>/commit/abc1234

Edge Cases