feat(70): platform compat patches, install scripts, README platform table

- Windows taskkill for graceful process stop
- PID EPERM handling for cross-user process checks
- Cross-platform install scripts (install.sh + install.ps1)
- README: supported platforms table, service manager details

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: lidge-jun

README.md

@@ -30,6 +30,16 @@ Codex CLI / App / SDK ──/v1/responses──▶ opencodex ──▶ Any provi
               OpenRouter · Azure · DeepSeek · GLM · …and OpenAI itself
 ```
 
+## Supported platforms
+
+| OS | Status | Service manager |
+|---|---|---|
+| macOS (arm64 / x64) | Fully supported | launchd |
+| Linux (x64 / arm64) | Fully supported | systemd (user unit) |
+| Windows (x64) | Fully supported | Task Scheduler |
+
+Requires [Bun](https://bun.sh) 1.1+. All three platforms work natively (no WSL needed on Windows).
+
 ## Quick start
 
 ```bash
@@ -110,7 +120,7 @@ ocx status                     # is the proxy running?
 ocx login <xai|anthropic|kimi> # OAuth login
 ocx logout <provider>          # remove a stored login
 ocx gui                        # open the web dashboard
-ocx service <install|start|stop|status|uninstall>   # run as a background service
+ocx service <install|start|stop|status|uninstall>   # background service (launchd/systemd/schtasks)
 ocx update                     # update opencodex to the latest published version
 ```
 

scripts/install.ps1

@@ -0,0 +1,20 @@
+#Requires -Version 5.1
+$ErrorActionPreference = "Stop"
+
+Write-Host "Installing opencodex..." -ForegroundColor Cyan
+
+# Check or install Bun
+if (-not (Get-Command bun -ErrorAction SilentlyContinue)) {
+    Write-Host "Bun not found. Installing..."
+    irm bun.sh/install.ps1 | iex
+    $env:PATH = "$env:USERPROFILE\.bun\bin;$env:PATH"
+}
+
+$bunVer = & bun --version
+Write-Host "Using Bun v$bunVer"
+
+# Install opencodex globally
+& bun add -g @bitkyc08/opencodex
+
+Write-Host ""
+Write-Host "opencodex installed! Run 'ocx init' to set up." -ForegroundColor Green

scripts/install.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+set -euo pipefail
+
+echo "Installing opencodex..."
+
+# Check or install Bun
+if ! command -v bun &>/dev/null; then
+  echo "Bun not found. Installing..."
+  curl -fsSL https://bun.sh/install | bash
+  export PATH="$HOME/.bun/bin:$PATH"
+fi
+
+BUN_VER=$(bun --version)
+echo "Using Bun v$BUN_VER"
+
+# Install opencodex globally
+bun add -g @bitkyc08/opencodex
+
+echo ""
+echo "✅ opencodex installed! Run 'ocx init' to set up."

src/cli.ts

@@ -84,11 +84,22 @@ function handleStart() {
   process.on("SIGTERM", shutdown);
 }
 
+function killProxy(pid: number): void {
+  if (process.platform === "win32") {
+    try {
+      (require("node:child_process") as typeof import("node:child_process"))
+        .execSync(`taskkill /PID ${pid} /T /F`, { stdio: "pipe" });
+    } catch { /* process already gone */ }
+  } else {
+    process.kill(pid, "SIGTERM");
+  }
+}
+
 function handleStop() {
   const pid = readPid();
   if (pid) {
     try {
-      process.kill(pid, "SIGTERM");
+      killProxy(pid);
       console.log(`✅ Proxy (PID ${pid}) stopped.`);
     } catch {
       console.log("Proxy process not found.");

src/config.ts

@@ -94,7 +94,13 @@ export function readPid(): number | null {
     const raw = readFileSync(PID_PATH, "utf-8").trim();
     const pid = parseInt(raw, 10);
     if (isNaN(pid)) return null;
-    try { process.kill(pid, 0); return pid; } catch { return null; }
+    try {
+      process.kill(pid, 0);
+      return pid;
+    } catch (e: unknown) {
+      if ((e as NodeJS.ErrnoException).code === "EPERM") return pid;
+      return null;
+    }
   } catch {
     return null;
   }