Add cross-platform ORW support

Author: ualtinok

.alfonso/release-notes/v0.1.0.md

@@ -1,13 +1,14 @@
 # @cortexkit/orw v0.1.0
 
-Initial public release of ORW, a local Bun-powered OpenCode release integration watcher.
+Initial public release of ORW, a local Bun-powered OpenCode release integration watcher for macOS, Linux, and Windows.
 
 ## Highlights
 
 - Initialize a per-project watcher config with `bunx @cortexkit/orw init`.
 - Watch upstream OpenCode releases and build integrated local artifacts.
 - Merge selected local branches, GitHub branch URLs, and upstream PR URLs in order.
-- Build and verify the OpenCode CLI and Electron desktop app before install.
+- Build and verify the native OpenCode CLI on macOS, Linux, and Windows.
+- Optionally package the Electron desktop app for the host platform. macOS can auto-install the `.app`; Linux and Windows desktop packages are verified and left for manual install.
 - Install immediately or defer until OpenCode exits.
 
 ## Safety

CHANGELOG.md

@@ -6,4 +6,4 @@ Full user-facing release notes live in GitHub Releases. This file is a lightweig
 
 ## 0.1.x
 
-- **0.1.0** — Initial public release of `@cortexkit/orw`: Bun-powered OpenCode release integration watcher with local branch, GitHub branch URL, and GitHub PR URL support.
+- **0.1.0** — Initial public release of `@cortexkit/orw`: Bun-powered OpenCode release integration watcher with macOS/Linux/Windows CLI support plus local branch, GitHub branch URL, and GitHub PR URL integration sources.

README.md

@@ -1,12 +1,12 @@
 # @cortexkit/orw
 
-OpenCode Release Watch (`orw`) is a local macOS automation tool for rebuilding OpenCode releases with your selected integration refs.
+OpenCode Release Watch (`orw`) is a local automation tool for rebuilding OpenCode releases with your selected integration refs.
 
-It watches `anomalyco/opencode` releases, creates a disposable clone, fetches your configured local branches / GitHub branch URLs / upstream PR URLs, asks `opencode run` to merge them onto the release tag, builds the CLI and desktop app, then offers to install the verified artifacts.
+It watches `anomalyco/opencode` releases, creates a disposable clone, fetches your configured local branches / GitHub branch URLs / upstream PR URLs, asks `opencode run` to merge them onto the release tag, builds the native CLI, optionally packages the Electron desktop app, then records the verified artifacts.
 
 ## Requirements
 
-- macOS
+- macOS, Linux, or Windows
 - [Bun](https://bun.sh/)
 - `git`
 - `opencode` on `PATH`
@@ -42,7 +42,7 @@ bunx @cortexkit/orw check --force
 
 ## Config
 
-`init` writes `orw.config.json` in the current directory:
+`init` writes `orw.config.json` in the current directory. On macOS it looks like:
 
 ```json
 {
@@ -54,7 +54,7 @@ bunx @cortexkit/orw check --force
   "base_branch": "dev",
   "branches": [],
   "poll_minutes": 30,
-  "agent": "Alfonso - CTO",
+  "agent": "build",
   "model": "openai/gpt-5.5-fast",
   "opencode_bin": "opencode",
   "desktop_target": "/Applications/OpenCode.app",
@@ -96,6 +96,7 @@ Relative paths in config are resolved from the directory containing `orw.config.
 - `work_repo`: disposable OpenCode clone used for each integration attempt
 - `runtime_dir`: lock files, logs, and last-success state
 - `prompt_path`: optional custom prompt template; if omitted, the packaged default prompt is used
+- `install_desktop`: defaults to `true` on macOS and `false` on Linux/Windows when generated by `init`
 
 ## Commands
 
@@ -119,6 +120,8 @@ bunx @cortexkit/orw --config /path/to/orw.config.json preview
 
 ## launchd
 
+`launchd` integration is macOS-only. On Linux or Windows, run `bunx @cortexkit/orw check` from your scheduler of choice.
+
 Install a launchd job for periodic checks:
 
 ```bash
@@ -135,10 +138,10 @@ bunx @cortexkit/orw launchd uninstall
 
 ## Install behavior
 
-- CLI install runs OpenCode's upstream `install` script with `--binary <local build> --no-modify-path`.
-- Desktop install copies the packaged Electron `.app` bundle to `desktop_target`.
+- CLI install copies the verified native binary to `~/.opencode/bin/opencode` (`opencode.exe` on Windows).
+- On macOS, desktop install copies the packaged Electron `.app` bundle to `desktop_target`, removes quarantine xattrs, ad-hoc codesigns it, and opens it.
+- On Linux and Windows, desktop packaging can be enabled with `install_desktop: true`; ORW verifies and records the resulting package, but desktop auto-install is manual for now.
 - Install is blocked while OpenCode is running. If that happens, run `bunx @cortexkit/orw install-when-closed`, then quit OpenCode.
-- The desktop app has quarantine xattrs removed and is ad-hoc codesigned after copying.
 
 ## Safety
 

config.example.json

@@ -12,6 +12,6 @@
   "opencode_bin": "opencode",
   "desktop_target": "/Applications/OpenCode.app",
   "install_cli": true,
-  "install_desktop": true,
+  "install_desktop": false,
   "notify_timeout": 120
 }

package.json

@@ -8,7 +8,9 @@
     "automation",
     "bun",
     "cli",
-    "macos"
+    "macos",
+    "linux",
+    "windows"
   ],
   "author": "Cortexkit",
   "license": "MIT",

prompt.txt

@@ -12,7 +12,8 @@ Requirements:
 - Name the branch {{branch}}.
 - Merge these refs in order: {{merges}}.
 - If there are merge conflicts, resolve them completely.
-- Build the host CLI and the Electron desktop app.
+- Build the host CLI.
+- {{desktop_requirement}}
 - The CLI must be compiled with stable release identity: OPENCODE_CHANNEL={{channel}} and OPENCODE_VERSION={{version}}.
 
 Exact tasks:
@@ -22,11 +23,8 @@ Exact tasks:
 4. Build the host CLI in `packages/opencode` with `OPENCODE_CHANNEL={{channel}} OPENCODE_VERSION={{version}} bun run build -- --single`.
 5. Ensure the built CLI binary exists at `{{cli}}`.
 6. Run `{{cli}} --version` and verify the output is exactly `{{version}}`.
-7. Prepare the production Electron desktop package in `packages/desktop` with `OPENCODE_CHANNEL=prod OPENCODE_VERSION={{version}} bun ./scripts/prepare.ts`.
-8. Build the production Electron desktop assets in `packages/desktop` with `OPENCODE_CHANNEL=prod OPENCODE_VERSION={{version}} bun run build`.
-9. Package the production Electron desktop app in `packages/desktop` with `OPENCODE_CHANNEL=prod OPENCODE_VERSION={{version}} bun run package:mac`.
-10. Confirm the desktop app bundle exists at `{{app}}`.
-11. Return a concise summary with the final branch name and artifact paths.
+{{desktop_tasks}}
+Return a concise summary with the final branch name and artifact paths.
 
 Context:
 - Upstream repo: {{release_repo}}
@@ -35,4 +33,4 @@ Context:
 - Integration refs:
 - {{sources}}
 
-If anything fails, fix it and continue until the branch is integrated and both builds succeed.
+If anything fails, fix it and continue until the branch is integrated and the configured build succeeds.