Add user installer and CLI usage instructions

README.md

@@ -0,0 +1,15 @@
+# budget
+
+Resource limits for desktop apps and terminal workloads. Requires Linux, cgroup v2, a systemd user session, and Go 1.26+.
+
+Copy `profiles.example.toml` to `~/.config/budget/profiles.toml` and edit limits, app IDs, and terminal prefixes.
+
+| Action                         | Command                          |
+| ------------------------------ | -------------------------------- |
+| Install and apply              | `./install.sh`                   |
+| Apply configuration edits      | `budget apply`                   |
+| Show configuration             | `budget status`                  |
+| Launch with a profile          | `budget run compute -- COMMAND`  |
+| Override a running app or unit | `budget set unrestricted TARGET` |
+| Test                           | `go test -race ./...`            |
+| Lint                           | `golangci-lint run`              |

install.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+set -eu
+cd -- "$(dirname -- "$0")"
+CGO_ENABLED=0 go build -trimpath -o bin/budget ./cmd/budget
+install -Dm755 bin/budget "$HOME/.local/bin/.budget.new"
+mv "$HOME/.local/bin/.budget.new" "$HOME/.local/bin/budget"
+test -f "$HOME/.config/budget/profiles.toml" || install -Dm644 profiles.example.toml "$HOME/.config/budget/profiles.toml"
+"$HOME/.local/bin/budget" apply