Local Release Test

Local Release Test

Use this skill when a developer asks to create, run, monitor, or explain the repository-local release testing workflow for InternAgentS desktop builds.

The goal is to let different developers publish test releases from different branches in qzzqzzb/InternAgents without overwriting official releases or each other's test builds.

Release Model

• Official releases are triggered by pushing tags like v0.1.5 to InternScience/InternAgents.
• Official releases run and publish in InternScience/InternAgents using that repository's built-in GITHUB_TOKEN.
• Local test releases are triggered manually with workflow_dispatch.
• Local test releases publish to the current repository, normally qzzqzzb/InternAgents.
• Local test releases require secrets.INTERNAGENTS_LOCAL_RELEASE_TOKEN.
• Local test releases are marked as GitHub prereleases, so they do not replace the repository's latest stable release.
• Package-only builds are triggered manually with workflow_dispatch in InternScience/InternAgents.
• Package-only builds run in InternScience/InternAgents and upload workflow artifacts only; they do not create or update GitHub Releases.

The workflow generates test tags automatically:

v<base_version>-test.<safe_branch_name>.<utc_timestamp>

Example:

v0.1.5-test.zhf-local-release-for-test.20260603.192500

The timestamp is UTC in yyyyMMdd.HHmmss format. Branch separators and unsafe characters are normalized to hyphens.

The workflow intentionally does not define a custom GitHub Actions run-name; GitHub uses the default workflow run display. The final GitHub Release tag and title include the branch timestamp and are the source of truth for test release identity.

Before Running

1. Confirm the developer branch has been pushed to GitHub.
2. Confirm .github/workflows/release.yml on the default branch includes workflow_dispatch. If this workflow support is still only in a PR branch, merge that support first before relying on manual dispatch.
3. Confirm the branch includes the code that should be packaged.
4. Choose a base_version, usually the next version being tested, such as 0.1.5.
5. Confirm repository secret INTERNAGENTS_LOCAL_RELEASE_TOKEN exists and can write Contents to qzzqzzb/InternAgents.

Trigger From GitHub UI

1. Open qzzqzzb/InternAgents on GitHub.
2. Go to Actions.
3. Select the Release workflow.
4. Click Run workflow.
5. Select the development branch to package.
6. Set base_version.
7. Optionally set release_notes.
8. Start the workflow.

Trigger With GitHub CLI

Use gh when it is available and authenticated:

gh workflow run release.yml `
  --repo qzzqzzb/InternAgents `
  --ref <branch-name> `
  -f base_version=0.1.5 `
  -f release_notes="Testing <short summary>"

Then monitor the run:

gh run list --repo qzzqzzb/InternAgents --workflow release.yml --limit 5
gh run watch --repo qzzqzzb/InternAgents <run-id>

If gh is not installed, use the GitHub connector or GitHub web UI to inspect workflow runs.

Expected Artifacts

The workflow should publish a prerelease in qzzqzzb/InternAgents with:

• macOS Apple Silicon DMG
• macOS Intel DMG
• Windows x64 NSIS installer
• remote backend CLI tarball: internagents-backend-cli.tar.gz

The release notes include:

• generated test release tag
• desktop version used for packaging
• source branch and commit
• exact INTERNAGENTS_UPDATE_API_URL for testing app updates against that prerelease
• exact INTERNAGENTS_REMOTE_BACKEND_UPDATE_API_URL for testing remote backend CLI release sync against that prerelease

Official Package-Only Builds

Use the package-only workflow when the developer wants InternScience/InternAgents to run the build but does not want to publish a GitHub Release.

Trigger the workflow manually and point it at the source ref to package:

gh workflow run package.yml `
  --repo InternScience/InternAgents `
  -f source_repository=qzzqzzb/InternAgents `
  -f source_ref=main `
  -f desktop_version=0.1.5

Then monitor the run:

gh run list --repo InternScience/InternAgents --workflow package.yml --limit 5
gh run watch --repo InternScience/InternAgents <run-id>

Expected workflow artifacts:

• macOS Apple Silicon DMG
• macOS Intel DMG
• Windows x64 NSIS installer
• remote backend CLI tarball: internagents-backend-cli.tar.gz

The workflow does not create or edit a GitHub Release. Pushing a package tag is not part of this flow; for a private source repository, configure INTERNAGENTS_SOURCE_TOKEN in InternScience/InternAgents with read access to that source repository. This workflow does not update the InternScience/InternAgents main branch.