// Start, stop, restart, and verify the local PwrAgent Electron development app with `PWRAGENT_PROFILE=dev` from the current checkout. Use when Codex needs to close any running dev-profile PwrAgent instance, launch `pnpm dev` in the current working directory, or confirm the dev-profile app came up.
Prepare, validate, tag, publish, and monitor guarded PwrAgent desktop releases. Use when the user asks to release PwrAgent, prepare a vX.Y.Z or vX.Y.Z-prerelease tag, update release notes or CHANGELOG.md for a desktop release, verify package.json/tag/changelog alignment, trigger the macOS signed/notarized release workflow, or inspect release workflow status.
Safely restart the local PwrAgent Electron development app after pulling, rebasing, or merging changes. Use when Codex is running inside or alongside the PwrAgent dev app and a normal restart could kill the current session before `pnpm dev` is relaunched.
Record, export, derive, and refresh desktop replay-backed E2E fixtures for PwrAgent. Use when Codex needs to seed or update `apps/desktop/e2e/fixtures/*` from a live desktop session with Computer Use, add a new capture recipe, promote `raw.capture.jsonl` into `replay.fixture.json`, or wire a replay-backed Electron spec around a captured scenario.
| name | pwragent-dev-profile |
| description | Start, stop, restart, and verify the local PwrAgent Electron development app with `PWRAGENT_PROFILE=dev` from the current checkout. Use when Codex needs to close any running dev-profile PwrAgent instance, launch `pnpm dev` in the current working directory, or confirm the dev-profile app came up. |
Use this skill to manage the local PwrAgent Electron app for the dev profile from the checkout Codex is currently working in.
Run commands from the repository root unless the user asks for a different checkout.
Start or restart the dev-profile app:
.agents/skills/pwragent-dev-profile/scripts/pwragent-dev-profile.zsh restart --root "$PWD"
Close the dev-profile app if it is running:
.agents/skills/pwragent-dev-profile/scripts/pwragent-dev-profile.zsh close --root "$PWD"
Check whether the dev-profile app is running:
.agents/skills/pwragent-dev-profile/scripts/pwragent-dev-profile.zsh status --root "$PWD"
List the profile's recorded app instances and messaging lease owner:
.agents/skills/pwragent-dev-profile/scripts/pwragent-dev-profile.zsh leases
Verify that a previously started instance is still up:
.agents/skills/pwragent-dev-profile/scripts/pwragent-dev-profile.zsh verify --root "$PWD"
status first when the user asks what is running or when closing processes may be surprising.restart when the user asks to start the dev profile; it closes the prior managed dev-profile instance, starts PWRAGENT_PROFILE=dev PWRAGENT_INSTANCE_ROOT="$PWD" pnpm dev detached from the checkout, and waits until the app writes a matching profile runtime record.close when the user only wants the dev-profile app stopped..local/pwragent-dev-profile.log.--profile dev, --root "$PWD", .local/pwragent-dev-profile.pid, and .local/pwragent-dev-profile.log.restart over hand-running PWRAGENT_PROFILE=dev pnpm dev; the script passes PWRAGENT_INSTANCE_ROOT, starts a detached daemon helper, then uses the app's lease-backed runtime metadata in ~/.pwragent/profiles/dev/state/state.db to find the Electron owner process.pnpm dev supervisor when the first lease-backed Electron instance it started exits, so closing the spawned app does not leave a dev supervisor relaunching it.pnpm dev / electron-vite parent chain.leases when debugging which process owns the profile messaging lease.