docs: avoid cargo run in workflows

Author: rexleimo

README.md

@@ -15,6 +15,11 @@ Download the archive for your OS from GitHub Releases, extract it, and put `rexo
 ### Option B: Build from source
 
 ```bash
+# Install to ~/.cargo/bin (recommended for dev)
+cargo install --path crates/rexos-cli --locked
+rexos --help
+
+# Or build a local binary
 cargo build --release -p rexos-cli
 ./target/release/rexos --help
 ```

docs/plans/2026-03-01-cargo-workspace-split.md

@@ -14,7 +14,7 @@
 
 **Files:**
 - Modify: `Cargo.toml` (becomes virtual workspace)
-- Modify: `init.sh` (update `cargo run` target)
+- Modify: `init.sh` (run the built `rexos` binary for smoke checks)
 - Modify: `README.md` (update dev commands)
 - Create: `crates/rexos/Cargo.toml`
 - Create: `crates/rexos/src/lib.rs`
@@ -51,8 +51,8 @@ Each crate gets a minimal `lib.rs` that either owns code (moved modules) or re-e
 
 **Step 4: Update `init.sh` + README**
 
-- `init.sh` should use `cargo run -p rexos-cli -- --help`.
-- README examples should use `cargo run -p rexos-cli -- ...`.
+- `init.sh` should run the built binary for the smoke check: `./target/debug/rexos --help`.
+- README examples should use `rexos ...` (or `./target/<profile>/rexos ...` if not installed).
 
 ---
 
@@ -103,4 +103,3 @@ Run:
 git add -A
 git commit -m "refactor: split rexos into cargo workspace"
 ```
-

features.json

@@ -11,7 +11,7 @@
       "category": "functional",
       "priority": "p0",
       "description": "`rexos --help` prints CLI usage.",
-      "steps": ["Run `cargo run -- --help`", "Verify help text is printed and exit code is 0."],
+      "steps": ["Run `rexos --help`", "Verify help text is printed and exit code is 0."],
       "passes": false,
       "notes": ""
     },
@@ -20,7 +20,7 @@
       "category": "functional",
       "priority": "p0",
       "description": "`rexos init` creates `~/.rexos/config.toml` and `~/.rexos/rexos.db` if missing.",
-      "steps": ["Run `cargo run -- init`", "Verify config file exists", "Verify SQLite DB exists"],
+      "steps": ["Run `rexos init`", "Verify config file exists", "Verify SQLite DB exists"],
       "passes": false,
       "notes": ""
     },
@@ -107,4 +107,3 @@
     }
   ]
 }
-

init.sh

@@ -8,6 +8,7 @@ echo "[rexos] tests..."
 cargo test
 
 echo "[rexos] smoke: CLI help"
-cargo run -p rexos-cli -- --help >/dev/null
+cargo build -p rexos-cli
+./target/debug/rexos --help >/dev/null
 
 echo "[rexos] done"