All notable changes to @prevu/skills will be documented in this file. Format: Keep a Changelog. Versioning: SemVer. The 0.x line does not guarantee a stable skill structure.
- Remove compute-suspension guidance from the primary agent playbooks.
- Align lifecycle, troubleshooting, mirror-dev, and share-preview instructions with the current CLI/API/MCP surface.
- Clarify that exposed port state is managed through API/MCP/CLI rather than VM-local port-state files.
- Requires
@prevu/cli@0.2.3or newer for the updated README/version guidance. The command surface remains compatible with@prevu/cli@0.2.2.
- Document
prevu env urlsand theenv expose --format jsonurlfield. - Update preview-sharing flows to read
.data.urldirectly instead of constructing URLs fromhost. - Note that
--no-strict-hostsuppresses benign SSH known-hosts warnings.
- Requires
@prevu/cli@0.2.2or newer and a Prevu API that returnsurlfor exposed ports.
- Document
prevu env service start/list/logs/restart/stopas the default path for long-running dev servers and split backend/frontend services. - Update
prevu-flowsrecipes to use Prevu-managed services instead of hand-writtennohup, PID files, and broadpkill -frestarts.
- Requires
@prevu/cli@0.2.1or newer and a Prevu API with the lightweight service API routes.
- Slug rules tightened: lowercase letters/digits/hyphen only, must start with a letter and end with a letter/digit (RFC 1123 hostname-safe). Slugs are now globally unique rather than per-owner -
env createerrors with exit 5 if another user owns the slug.prevu/references/env.mdupdated. - Public exposed-port URLs are
<slug>-<port>.prevu.pagewith no user-hash prefix (matches the new Prevu API).
- Requires
@prevu/cli@0.2.0or newer and a Prevu API compatible with global slug ownership. Older CLI/API combinations may surface the legacyu<hash>-<slug>-<port>URL form.
- Document the
prevu env exec <slug> -- <cmd>command added in@prevu/cli@0.1.1. Bothprevuandprevu-flowsskill versions bumped in lockstep. prevu/references/env.md: section retitled tossh / exec / ssh-command. Recommendenv execas the canonical one-shot entry for agents; noteenv ssh -- <cmd>is equivalent and now actually forwards the trailing args (the previous CLI silently dropped them).prevu/SKILL.md: command map listsexec; install note bumps required CLI to >= 0.1.1 for the new command.prevu-flows/references/mirror-dev.md,share-preview.md: switched the existingenv ssh "$SLUG" -- "..."invocations toenv exec. Behavior is the same; intent is clearer and a missing command now fails loudly.prevu/references/troubleshooting.md: coversenv execalongsideenv sshfor the "exits != 0 with no output" row.
- Requires
@prevu/cli@0.1.1or newer. Older CLIs lackenv execand silently drop the trailing args ofenv ssh -- <cmd>.
Initial 2-skill layout (prevu + prevu-flows) with progressive-disclosure references/.