v0.25.0

What's in this release

Everything here comes from #69. It makes sure an AI agent setting up DeployHQ for someone actually reads the setup steps, and doesn't publish files that should stay private on the first deploy.

• New: dhq skills show [reference] prints DeployHQ's skill for AI agents (or one of its references) without installing anything. An agent can read it in the session it is working in; a skill installed with dhq skills install is only loaded by the agent's next session. Plain Markdown, also when piped; --json gives {name, content, references}.
• Agents are pointed at the setup steps. The first messages of a new setup (the "not signed in" guidance, dhq auth status --json, dhq doctor, the "No project specified" errors and dhq --help) now ask the agent to read them with dhq skills show. In --json output the recovery actions add read_setup_skill. Installing for future sessions is offered for the running agent only (for example dhq skills install --agent claude-code).
• Exclude files before the first deploy. Every file in the repository is uploaded unless excluded. The skill now says to check the files on the branch DeployHQ deploys (the remote's, not the local checkout) and exclude deploy scripts or local config first. Since dhq launch deploys straight away: create the project, add the exclusions, then run dhq launch --project <permalink>.
• No more ! for sign-in. "Sign in in a separate terminal window" now also says not to use the agent's ! shortcut, which gives dhq no terminal to prompt in. Agents suggested ! dhq auth login / ! dhq signup, which always refuse there.
• HTTPS repositories: repos create / repos update now check the branch against the repository and fail (exit code 1) with the branches and the command to pick one, instead of letting the first deployment fail. They no longer suggest adding a deploy key, which an HTTPS repository never uses.
• dhq deployments logs prints each entry's detail under its message, as the web app does (command output, the list of excluded files, an error's cause). Without --step, --json returns every step's logs.
• Skill updates: DeployHQ hosting is described as free during the beta, and may be billed once it ends. Copies installed by earlier versions now show as outdated, so dhq skills list flags them and dhq hello refreshes the running agent's copy.

Worth knowing when upgrading

• repos create / repos update --branch <name> with an HTTPS URL now exit 1 when the branch isn't in the repository. When the branch list can't be read, they carry on as before.
• dhq deployments logs output now includes each entry's detail lines. Piped output without --json stays text.

Full detail is in CHANGELOG.md → 0.25.0.

Full Changelog: v0.24.0...v0.25.0