release: build and upload binaries on tags

Author: rexleimo

.github/workflows/release.yml

@@ -0,0 +1,74 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    name: build (${{ matrix.target }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+            bin: target/release/rexos
+          - os: macos-13
+            target: x86_64-apple-darwin
+            bin: target/release/rexos
+          - os: macos-14
+            target: aarch64-apple-darwin
+            bin: target/release/rexos
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+            bin: target/release/rexos.exe
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Rust cache
+        uses: Swatinem/rust-cache@v2
+
+      - name: Build (release)
+        run: cargo build --release -p rexos-cli --locked
+
+      - name: Package
+        run: python3 scripts/package_release.py --version "${{ github.ref_name }}" --target "${{ matrix.target }}" --bin "${{ matrix.bin }}" --out-dir dist
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-${{ matrix.target }}
+          path: dist/*
+          if-no-files-found: error
+
+  publish:
+    name: publish (github release)
+    runs-on: ubuntu-latest
+    needs: build
+
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+
+      - name: List assets
+        run: ls -la dist
+
+      - name: Publish GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/**
+          generate_release_notes: true
+

README.md

@@ -6,6 +6,19 @@ RexOS is a long-running agent operating system: persistent memory, tool sandboxi
 
 This repository is bootstrapped with a long-running harness (`features.json`, `init.sh`, `rexos-progress.md`). Work is tracked by flipping feature `passes` from `false` → `true`.
 
+## Install
+
+### Option A: Download a prebuilt binary (recommended)
+
+Download the archive for your OS from GitHub Releases, extract it, and put `rexos` (or `rexos.exe`) somewhere on your `PATH`.
+
+### Option B: Build from source
+
+```bash
+cargo build --release -p rexos-cli
+./target/release/rexos --help
+```
+
 ## Quick start (dev)
 
 ```bash
@@ -21,15 +34,24 @@ RexOS defaults to `ollama` at `http://127.0.0.1:11434/v1` in `~/.rexos/config.to
 ollama serve
 
 # 2) Init RexOS (creates ~/.rexos/config.toml + ~/.rexos/rexos.db)
-cargo run -p rexos-cli -- init
+rexos init
 
 # 3) Run an agent session in a workspace directory
 mkdir -p /tmp/rexos-work
-cargo run -p rexos-cli -- agent run --workspace /tmp/rexos-work --prompt "Create hello.txt with the word hi"
+rexos agent run --workspace /tmp/rexos-work --prompt "Create hello.txt with the word hi"
 ```
 
 To run the optional Ollama smoke test: `REXOS_OLLAMA_MODEL=<your-model> cargo test -p rexos -- --ignored`.
 
+## Releasing (maintainers)
+
+Pushing a `v*` tag triggers the Release workflow which attaches prebuilt archives to a GitHub Release.
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
 ## Providers & routing
 
 RexOS supports multiple LLM providers via drivers: