@technomoron/agent-run 0.99.19 → 0.99.20

package/CHANGES

@@ -1,6 +1,11 @@
 CHANGES
 =======
 
+Version 0.99.20 (2026-06-03)
+----------------------------
+* Add systemd unit templates and install tooling for the global AI tools updater.
+* Add a login warning helper that prints a large banner when `~/.agent-config` has uncommitted changes.
+
 Version 0.99.19 (2026-06-03)
 ----------------------------
 * Link per-profile Codex `auth.json` files to the shared `~/.codex/auth.json` login cache when available.

package/README.md

@@ -255,6 +255,40 @@ review files into `reviews/`, moves loose `memory*.md` files into `memories/`,
 and moves old Codex runtime files into `memories/codex-home` when doing so does
 not overwrite existing files.
 
+## Systemd Jobs
+
+The repo includes optional systemd units for keeping global AI tooling current.
+
+Install the global AI tools updater:
+
+```sh
+sudo scripts/install-systemd-jobs.sh --ai-tools
+```
+
+This installs and enables `ai-tools-update.timer`, which runs hourly. The
+package list is configurable through systemd environment overrides:
+
+```text
+AI_TOOLS_NPM_PACKAGES="npm pnpm netlify-cli@latest @openai/codex@latest @anthropic-ai/claude-code@latest @technomoron/agent-run@latest @technomoron/repo-check@latest"
+AI_TOOLS_APT_PACKAGES="gh"
+```
+
+## Login Warning
+
+For user-owned machines, `scripts/agent-config-login-warning.sh` can be called
+from a shell startup file to print a large warning when `~/.agent-config` is a
+dirty git checkout:
+
+```csh
+if ( -x "$HOME/bin/agent-config-login-warning" ) then
+    "$HOME/bin/agent-config-login-warning"
+endif
+```
+
+The helper only reads the git status and exits quietly when the checkout is
+clean or absent. Set `AGENT_CONFIG_TARGET` before calling it to check a
+different config tree.
+
 ## Install
 
 ```sh

package/ops/systemd/ai-tools-update.service

@@ -0,0 +1,11 @@
+[Unit]
+Description=Update global AI and developer CLI packages
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=oneshot
+Environment=HOME=/root
+Environment=NPM_CONFIG_PREFIX=/usr
+Environment=PNPM_HOME=/usr/local/bin
+ExecStart=/usr/local/lib/agent-run/update-ai-tools.sh

package/ops/systemd/ai-tools-update.timer

@@ -0,0 +1,11 @@
+[Unit]
+Description=Run AI tool updater hourly
+
+[Timer]
+OnBootSec=10m
+OnUnitActiveSec=1h
+AccuracySec=5m
+Unit=ai-tools-update.service
+
+[Install]
+WantedBy=timers.target

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@technomoron/agent-run",
-  "version": "0.99.19",
+  "version": "0.99.20",
   "packageManager": "pnpm@10.28.1",
   "bin": {
     "agent-run": "dist/agent-run.js"
@@ -8,6 +8,10 @@
   "files": [
     "dist/",
     "examples/",
+    "ops/",
+    "scripts/agent-config-login-warning.sh",
+    "scripts/install-systemd-jobs.sh",
+    "scripts/update-ai-tools.sh",
     "README.md",
     "LICENSE",
     "CHANGES"

package/scripts/agent-config-login-warning.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env sh
+set -u
+
+target="${AGENT_CONFIG_TARGET:-$HOME/.agent-config}"
+
+[ -d "$target/.git" ] || exit 0
+command -v git >/dev/null 2>&1 || exit 0
+
+status="$(git -C "$target" status --short 2>/dev/null)" || exit 0
+[ -n "$status" ] || exit 0
+
+cat <<'BANNER'
+
+###############################################################################
+###############################################################################
+##                                                                           ##
+##        WARNING: ~/.agent-config HAS UNCOMMITTED LOCAL CHANGES             ##
+##                                                                           ##
+##        agent-run config updates should not pull over this tree.           ##
+##        Commit, stash, or remove these changes before updating configs.    ##
+##                                                                           ##
+###############################################################################
+###############################################################################
+
+BANNER
+
+printf '%s\n' "$status" | sed 's/^/  /'
+printf '\n'

package/scripts/install-systemd-jobs.sh

@@ -0,0 +1,84 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+	cat <<'USAGE'
+Usage:
+  install-systemd-jobs.sh [options]
+
+Options:
+  --ai-tools                  Install and enable ai-tools-update.timer.
+  --all                       Install all repo-provided systemd jobs.
+  --dry-run                   Print actions without writing system files.
+  -h, --help                  Show this help.
+
+Examples:
+  sudo scripts/install-systemd-jobs.sh --ai-tools
+  sudo scripts/install-systemd-jobs.sh --all
+USAGE
+}
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+INSTALL_LIB_DIR="${INSTALL_LIB_DIR:-/usr/local/lib/agent-run}"
+SYSTEMD_DIR="${SYSTEMD_DIR:-/etc/systemd/system}"
+ORIGINAL_ARGS=("$@")
+
+INSTALL_AI_TOOLS=0
+INSTALL_ALL=0
+DRY_RUN=0
+
+while [ "$#" -gt 0 ]; do
+	case "$1" in
+		--ai-tools)
+			INSTALL_AI_TOOLS=1
+			shift
+			;;
+		--all)
+			INSTALL_ALL=1
+			INSTALL_AI_TOOLS=1
+			shift
+			;;
+		--dry-run)
+			DRY_RUN=1
+			shift
+			;;
+		-h|--help)
+			usage
+			exit 0
+			;;
+		*)
+			echo "Unknown option: $1" >&2
+			usage >&2
+			exit 2
+			;;
+	esac
+done
+
+if [ "$INSTALL_AI_TOOLS" -eq 0 ]; then
+	usage >&2
+	exit 2
+fi
+
+if [ "$DRY_RUN" -eq 0 ] && [ "${EUID:-$(id -u)}" -ne 0 ]; then
+	exec sudo "$0" "${ORIGINAL_ARGS[@]}"
+fi
+
+run() {
+	if [ "$DRY_RUN" -eq 1 ]; then
+		printf '+'
+		printf ' %q' "$@"
+		printf '\n'
+		return 0
+	fi
+	"$@"
+}
+
+run install -d -m 0755 "$INSTALL_LIB_DIR" "$SYSTEMD_DIR"
+run install -m 0755 "$ROOT/scripts/update-ai-tools.sh" "$INSTALL_LIB_DIR/update-ai-tools.sh"
+run install -m 0644 "$ROOT/ops/systemd/ai-tools-update.service" "$SYSTEMD_DIR/ai-tools-update.service"
+run install -m 0644 "$ROOT/ops/systemd/ai-tools-update.timer" "$SYSTEMD_DIR/ai-tools-update.timer"
+
+if [ "$INSTALL_AI_TOOLS" -eq 1 ]; then
+	run systemctl daemon-reload
+	run systemctl enable --now ai-tools-update.timer
+fi

package/scripts/update-ai-tools.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+export HOME="${HOME:-/root}"
+export NPM_CONFIG_PREFIX="${NPM_CONFIG_PREFIX:-/usr}"
+export PNPM_HOME="${PNPM_HOME:-/usr/local/bin}"
+export PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:${PATH:-}"
+
+NPM_BIN="${AI_TOOLS_NPM_BIN:-/usr/bin/npm}"
+APT_GET_BIN="${AI_TOOLS_APT_GET_BIN:-/usr/bin/apt-get}"
+
+AI_TOOLS_NPM_PACKAGES="${AI_TOOLS_NPM_PACKAGES:-npm pnpm netlify-cli@latest @openai/codex@latest @anthropic-ai/claude-code@latest @technomoron/agent-run@latest @technomoron/repo-check@latest}"
+AI_TOOLS_APT_PACKAGES="${AI_TOOLS_APT_PACKAGES:-gh}"
+
+if [ -n "$AI_TOOLS_NPM_PACKAGES" ]; then
+	# shellcheck disable=SC2086
+	"$NPM_BIN" install -g --force $AI_TOOLS_NPM_PACKAGES
+fi
+
+if [ -n "$AI_TOOLS_APT_PACKAGES" ] && command -v "$APT_GET_BIN" >/dev/null 2>&1; then
+	# shellcheck disable=SC2086
+	"$APT_GET_BIN" install --only-upgrade -y $AI_TOOLS_APT_PACKAGES
+fi