release(v0.3.1): add release installer groundwork

Author: error311

.github/workflows/release-artifacts.yml

@@ -57,9 +57,11 @@ jobs:
           name="runglass-${version}-${target}"
           mkdir -p "dist/${name}"
           mkdir -p "dist/${name}/share/man/man1"
+          mkdir -p "dist/${name}/scripts"
           cp target/release/runglass "dist/${name}/"
           cp README.md CHANGELOG.md LICENSE "dist/${name}/"
           cp docs/man/*.1 "dist/${name}/share/man/man1/"
+          cp scripts/install-release.sh "dist/${name}/scripts/"
           tar -C dist -czf "dist/${name}.tar.gz" "${name}"
           sha256sum "dist/${name}.tar.gz" > "dist/${name}.tar.gz.sha256"
 
@@ -125,9 +127,11 @@ jobs:
           name="runglass-${version}-${target}"
           mkdir -p "dist/${name}"
           mkdir -p "dist/${name}/share/man/man1"
+          mkdir -p "dist/${name}/scripts"
           cp target/release/runglass "dist/${name}/"
           cp README.md CHANGELOG.md LICENSE "dist/${name}/"
           cp docs/man/*.1 "dist/${name}/share/man/man1/"
+          cp scripts/install-release.sh "dist/${name}/scripts/"
           tar -C dist -czf "dist/${name}.tar.gz" "${name}"
           shasum -a 256 "dist/${name}.tar.gz" > "dist/${name}.tar.gz.sha256"
 

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## v0.3.1 - 05/28/2026
+
+- Added `scripts/install-release.sh` for installing release archives into a user-selected prefix, including the `runglass` binary, generated man pages, and docs.
+- Release archives now include the installer script alongside the binary, README, changelog, license, and `share/man/man1/` pages.
+- Documented the difference between `cargo install` and release archive installation: Cargo installs the binary only, while release archives can install man pages.
+
 ## v0.3.0 - 05/15/2026
 
 - Added `runglass run --review -- <command>` for a guided post-run flow that summarizes impact and offers keep, revert preview, supported file revert, export, or open-UI actions.

Cargo.lock

@@ -7,7 +7,7 @@ members = [
 resolver = "2"
 
 [workspace.package]
-version = "0.3.0"
+version = "0.3.1"
 edition = "2021"
 license = "MIT"
 repository = "https://github.com/error311/runglass"

Cargo.toml

@@ -68,6 +68,8 @@ Install from crates.io:
 cargo install runglass --locked
 ```
 
+Cargo installs the `runglass` binary only. Use a release archive if you also want generated man pages installed.
+
 Prebuilt release archives are published from tagged GitHub releases and include SHA-256 checksum files:
 
 ```text
@@ -85,6 +87,35 @@ Release archives also include generated man pages under `share/man/man1/`:
 man ./share/man/man1/runglass.1
 ```
 
+Install a downloaded release archive into `~/.local`:
+
+```bash
+tar -xzf runglass-<version>-<target>.tar.gz
+cd runglass-<version>-<target>
+./scripts/install-release.sh
+```
+
+Or install directly from an archive path into a custom prefix:
+
+```bash
+PREFIX=/tmp/runglass-install ./scripts/install-release.sh ./runglass-<version>-<target>.tar.gz
+```
+
+If `~/.local/bin` and `~/.local/share/man` are on your path/manpath, this gives you:
+
+```bash
+runglass --version
+man runglass
+```
+
+Uninstall a default user-prefix install:
+
+```bash
+rm -f "$HOME/.local/bin/runglass"
+rm -f "$HOME/.local/share/man/man1"/runglass*.1
+rm -rf "$HOME/.local/share/doc/runglass"
+```
+
 For local development, install this checkout into your Cargo bin directory:
 
 ```bash

README.md

@@ -12,8 +12,8 @@ description = "Run one command and get a live receipt of what happened."
 anyhow = "1.0"
 chrono = "0.4"
 clap = { version = "4.5", features = ["derive"] }
-runglass-core = { path = "../runglass-core", version = "0.3.0" }
-runglass-web = { path = "../runglass-web", version = "0.3.0" }
+runglass-core = { path = "../runglass-core", version = "0.3.1" }
+runglass-web = { path = "../runglass-web", version = "0.3.1" }
 serde_json = "1.0"
 ureq = { version = "2.12", features = ["json"] }
 

crates/runglass-cli/Cargo.toml

@@ -2151,7 +2151,7 @@ mod tests {
         let mut buffer = Vec::new();
         clap_mangen::Man::new(command)
             .title(title)
-            .date("2026-05-15")
+            .date("2026-05-28")
             .source(format!("runglass {}", env!("CARGO_PKG_VERSION")))
             .manual("RunGlass Manual")
             .render(&mut buffer)

crates/runglass-cli/src/main.rs

@@ -11,7 +11,7 @@ description = "Embedded local web UI and export renderer for RunGlass receipts."
 [dependencies]
 anyhow = "1.0"
 chrono = { version = "0.4", features = ["serde"] }
-runglass-core = { path = "../runglass-core", version = "0.3.0" }
+runglass-core = { path = "../runglass-core", version = "0.3.1" }
 serde_json = "1.0"
 tiny_http = "0.12"
 ureq = { version = "2.12", features = ["json"] }

crates/runglass-web/Cargo.toml

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH runglass-ci 1 2026-05-15 "runglass 0.3.0" "RunGlass Manual"
+.TH runglass-ci 1 2026-05-28 "runglass 0.3.1" "RunGlass Manual"
 .SH NAME
 runglass\-ci \- Run one command in CI and write receipt artifacts
 .SH SYNOPSIS

docs/man/runglass-ci.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH runglass-delete 1 2026-05-15 "runglass 0.3.0" "RunGlass Manual"
+.TH runglass-delete 1 2026-05-28 "runglass 0.3.1" "RunGlass Manual"
 .SH NAME
 runglass\-delete
 .SH SYNOPSIS