kandev/docs/release.md

Releases

This repo ships two things:

• Kandev runtime bundles (backend + web) published to GitHub Releases.
• NPX launcher (kandev on npm) that downloads and runs those bundles.

Packaging the web bundle

The release workflow calls:

scripts/release/package-web.sh

It packages the Next.js standalone output into dist/web/, which is then bundled into each platform ZIP.

Release flow (runtime bundles)

1. Pick a version tag:

git tag v0.1.0
git push origin v0.1.0

Or use the helper script (creates and pushes the tag):

scripts/release/publish-release.sh 0.1.0

2. GitHub Actions will:
   • Build the web app in standalone mode.
   • Build kandev + agentctl binaries for each platform.
   • Package and upload kandev-<platform>.zip and .sha256 to the release.

Publish the NPX launcher

The launcher package lives at apps/cli and is published as kandev.

cd apps/cli
pnpm build
npm publish --access public

Or use the helper script:

scripts/release/publish-launcher.sh 0.1.0

Releasing a new Kandev version

1. Update versions:
   • Bump apps/cli/package.json (npm package version).
   • The publish-release.sh script will error if this doesn't match the tag.
2. Tag and push the release (vX.Y.Z).
3. Publish the launcher to npm (same version or higher).
4. Verify:
   • npx kandev@latest downloads the new release bundle.
   • npx kandev prompts to update if an older launcher is installed.

Notes

• Release assets are downloaded to ~/.kandev/bin/<version>/<platform>/.
• Local data is stored under ~/.kandev/data/.