Update package versions to 0.0.1 and add CHANGELOG for first public release

- Set version to 0.0.1 for all applications and packages in the monorepo.
- Introduce CHANGELOG.md to document notable changes and version history.
- Add release notes and asset manifest for the first public version (v0.0.1).
- Update documentation for release processes and version management.

Author: BunsDev

CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.0.1] - 2026-03-27
+
+First public version tag. See [docs/releases/v0.0.1.md](docs/releases/v0.0.1.md) for full notes and [docs/releases/v0.0.1/assets.md](docs/releases/v0.0.1/assets.md) for release asset inventory.
+
+### Added
+
+- Initial tagged release of the OK Code monorepo (web UI, WebSocket server, desktop app, shared contracts).
+- Published CLI npm package `okcode` aligned with this version (see `apps/server`).
+- Desktop installers and update metadata published via GitHub Releases when CI runs for tag `v0.0.1`.
+
+[0.0.1]: https://github.com/OpenKnots/okcode/releases/tag/v0.0.1

apps/desktop/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okcode/desktop",
-  "version": "0.0.14",
+  "version": "0.0.1",
   "private": true,
   "main": "dist-electron/main.js",
   "scripts": {

apps/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okcode",
-  "version": "0.0.14",
+  "version": "0.0.1",
   "license": "MIT",
   "repository": {
     "type": "git",

apps/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okcode/web",
-  "version": "0.0.14",
+  "version": "0.0.1",
   "private": true,
   "type": "module",
   "scripts": {

bun.lock

@@ -130,7 +130,7 @@ Checklist:
 ## 4) Ongoing release checklist
 
 1. Ensure `main` is green in CI.
-2. Bump app version as needed.
+2. Bump app version as needed (see `scripts/update-release-package-versions.ts` and [CHANGELOG.md](../CHANGELOG.md) / [docs/releases/](releases/README.md) for notes).
 3. Create release tag: `vX.Y.Z`.
 4. Push tag.
 5. Verify workflow steps:

docs/release.md

@@ -0,0 +1,9 @@
+# Release notes
+
+Human-readable notes and asset inventories for tagged releases.
+
+| Version            | Notes            | Assets                       |
+| ------------------ | ---------------- | ---------------------------- |
+| [0.0.1](v0.0.1.md) | First public tag | [manifest](v0.0.1/assets.md) |
+
+The repository root [CHANGELOG.md](../../CHANGELOG.md) summarizes versions in Keep a Changelog form.

docs/releases/README.md

@@ -0,0 +1,24 @@
+# OK Code v0.0.1
+
+**Date:** 2026-03-27  
+**Tag:** [`v0.0.1`](https://github.com/OpenKnots/okcode/releases/tag/v0.0.1)
+
+## Summary
+
+First versioned release of OK Code: a minimal web GUI for coding agents (Codex-first), plus a desktop shell and a publishable CLI.
+
+## Highlights
+
+- **Web app (`apps/web`)** — Session UX, conversation and event rendering, WebSocket client to the local server.
+- **Server (`apps/server`, npm `okcode`)** — WebSocket API, Codex app-server integration (JSON-RPC over stdio), provider sessions.
+- **Desktop (`apps/desktop`)** — Electron wrapper with update checks against GitHub Releases (see [docs/release.md](../release.md)).
+- **Contracts (`packages/contracts`)** — Shared schemas and protocol types.
+
+## Upgrade and install
+
+- **CLI:** `npm install -g okcode@0.0.1` (or your preferred package manager) after the npm publish step from the release workflow.
+- **Desktop:** Download platform artifacts from the [GitHub Releases](https://github.com/OpenKnots/okcode/releases) page for this tag. Filenames are listed in [assets.md](v0.0.1/assets.md).
+
+## Known limitations
+
+This repository remains **early work in progress**. Expect rough edges around session recovery, streaming edge cases, and platform-specific desktop behavior. Report issues on GitHub.

docs/releases/v0.0.1.md

@@ -0,0 +1,28 @@
+# v0.0.1 — Release assets (manifest)
+
+Binaries are **not** stored in this git repository; they are attached to the [GitHub Release for `v0.0.1`](https://github.com/OpenKnots/okcode/releases/tag/v0.0.1) by the [Release Desktop workflow](../../.github/workflows/release.yml).
+
+After the workflow completes, expect artifacts similar to the following (exact names may include the product name `OK Code` and version `0.0.1`).
+
+## Desktop installers and payloads
+
+| Platform            | Kind           | Typical pattern |
+| ------------------- | -------------- | --------------- |
+| macOS Apple Silicon | DMG            | `*.dmg` (arm64) |
+| macOS Intel         | DMG            | `*.dmg` (x64)   |
+| macOS               | ZIP (updater)  | `*.zip`         |
+| Linux x64           | AppImage       | `*.AppImage`    |
+| Windows x64         | NSIS installer | `*.exe`         |
+
+## Electron updater metadata
+
+| File               | Purpose                                                   |
+| ------------------ | --------------------------------------------------------- |
+| `latest-mac.yml`   | macOS update manifest (merged from per-arch builds in CI) |
+| `latest-linux.yml` | Linux update manifest                                     |
+| `latest.yml`       | Windows update manifest                                   |
+| `*.blockmap`       | Differential download block maps                          |
+
+## Checksums
+
+SHA-256 checksums are not committed here; verify downloads via GitHub’s release UI or `gh release download` if you use the GitHub CLI.

docs/releases/v0.0.1/assets.md

@@ -1,6 +1,6 @@
 {
   "name": "@okcode/contracts",
-  "version": "0.0.14",
+  "version": "0.0.1",
   "private": true,
   "files": [
     "dist"