# open-wrap-url

Opens the Power Apps Wrap page for a given app ID and environment, and prints the URL.

Skill by Microsoft. Category: Shipping and ops.

## Install

Project (for this project only):

```sh
npx skills add microsoft/power-platform-skills --skill open-wrap-url
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add microsoft/power-platform-skills --skill open-wrap-url -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.
- Runs shell commands: Its steps run shell commands in your terminal.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 109. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/microsoft/power-platform-skills/open-wrap-url)

## Source

[Open the source](https://github.com/microsoft/power-platform-skills/tree/HEAD/plugins/mobile-apps/skills/open-wrap-url). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: open-wrap-url
description: Use when the user wants to open the Power Apps Wrap page for an app ID in the active environment.
user-invocable: true
allowed-tools: Read, Bash
model: haiku
---

> **Plugin check**: Run `node "${PLUGIN_ROOT}/scripts/check-version.js"` - if it outputs a message, show it to the user before proceeding.

**📋 Shared instructions: [shared-instructions.md](../../shared/shared-instructions.md)** — read first.

# Open Wrap URL

Builds and opens the Wrap URL for a code app:

`https://make.powerapps.com/environments/<envID>/wrap?appID=<appID>` for `--env Prod`

`https://make.test.powerapps.com/environments/<envID>/wrap?appID=<appID>` for `--env Test`

This skill delegates URL construction and browser open behavior to `scripts/open-wrap-url.js`.

## Workflow

1. Resolve app ID + env ID → 2. Open Wrap URL

---

### Step 1 — Resolve app ID + env ID

**Telemetry checkpoint: `resolve_wrap_target`**

Both arguments are required:

- `--app-id <app-id>`
- `--env-id <environment-id>`

Optional host selector:

- `--env <Prod|Test>` (default: `Prod`)

If either value is missing in `$ARGUMENTS`, ask once for the missing value(s). If still missing, STOP.

### Step 2 — Open Wrap URL

**Telemetry checkpoint: `open_power_apps_wrap`**

Run from the plugin root (or any app root):

```bash
node scripts/open-wrap-url.js --app-id "<app-id>" --env-id "<environment-id>" [--env "Prod|Test"]
```

Return the generated URL in the response. If the browser auto-open fails, still print the URL and tell the user to open it manually.

## Notes

- This skill is read-only with respect to project source files.
- Works on macOS (`open`), Linux (`xdg-open`), and Windows (`start`).
````

- Previous: [setup-offline-profile](https://syn4pse.dev/terminal/setup-offline-profile.md)
- Next: [assign-offline-profile](https://syn4pse.dev/terminal/assign-offline-profile.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
