@technomoron/agent-run 0.99.19 → 0.99.21

package/CHANGES

@@ -1,6 +1,17 @@
 CHANGES
 =======
 
+Version 0.99.21 (2026-06-27)
+----------------------------
+* Default project commands for `[code]/owner/repo` checkouts to `[code]/agent-config`.
+* Make `update --all` map profiles under a colocated `agent-config` root back to their matching project roots.
+* Expand integration coverage for the colocated config-root layout and Windows command/path behavior.
+
+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

@@ -3,8 +3,8 @@
 Small wrapper for AI coding CLIs like Codex and Claude.
 
 It keeps agent files out of normal repos and stores them in a separate
-agent config tree. That tree can live anywhere; it does not need to sit
-inside the source tree.
+agent config tree. By default, that tree lives beside owner/repo checkouts
+under the same code root.
 
 ## Model
 
@@ -18,27 +18,26 @@ Example:
 
 ```text
 ~/source/
+  agent-config/
+    org/
+      my-api/
+        agent-run.jsonc
+        local.md.njk
+        overrides/
+        AGENTS.md
+        CLAUDE.md
+        config.toml
+        .agents/
+        .claude/
+        bin/
   org/
     my-api/
-
-~/.agent-config/
-  org/
-    my-api/
-      agent-run.jsonc
-      local.md.njk
-      overrides/
-      AGENTS.md
-      CLAUDE.md
-      config.toml
-      .agents/
-      .claude/
-      bin/
 ```
 
-If your source repo is `~/source/org/my-api`, `agent-run` can map it to:
+If your source repo is `~/source/org/my-api`, `agent-run` maps it to:
 
 ```text
-~/.agent-config/org/my-api
+~/source/agent-config/org/my-api
 ```
 
 The source repo stays clean. The agent files live in the matching path under
@@ -93,7 +92,7 @@ AGENT_RUN_PROFILE=org/my-api
 
 Config root:
 
-- default: `~/.agent-config`
+- default for a project at `[code]/owner/repo`: `[code]/agent-config`
 - override with `--config-root /path/to/agent-configs`
 - override with `AGENT_CONFIG_DIR=/path/to/agent-configs`
 - override with `AGENT_CONFIG_ROOT=/path/to/agent-configs`
@@ -169,7 +168,8 @@ agent-run update --all ~/.agent-config
 ```
 
 If the config root argument is omitted, `update --all` uses the normal configured
-root such as `$HOME/.agent-config`.
+root. Without a project path, that falls back to `$HOME/.agent-config`; for
+project commands, the default is `[code]/agent-config`.
 
 You can also generate from a tool command and stop before launch:
 
@@ -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/dist/agent-run.js

@@ -675,7 +675,7 @@ function runUpdateAll(targetPath) {
     let updated = 0;
     for (const agentDir of profileDirs) {
         const profile = path.relative(configRoot, agentDir).replace(/\\/g, '/');
-        const projectRoot = projectRootForProfile(profile);
+        const projectRoot = projectRootForProfile(profile, configRoot);
         verbose(`update --all profile=${profile} syntheticProjectRoot=${projectRoot}`);
         ensureProfileOverridesDir(agentDir);
         convertLegacyProfileIfNeeded(configRoot, agentDir, profile);
@@ -2186,7 +2186,10 @@ function parseProfile(profile, source) {
     }
     return { profile: segments.join('/'), reason: '' };
 }
-function projectRootForProfile(profile) {
+function projectRootForProfile(profile, configRoot) {
+    if (configRoot && path.basename(configRoot) === 'agent-config') {
+        return path.join(path.dirname(configRoot), ...profile.split('/'));
+    }
     return path.join(os.homedir(), ...profile.split('/'));
 }
 function readAgentRunEnv(dir) {
@@ -2251,8 +2254,20 @@ function defaultConfigRoot(projectRoot) {
             return path.resolve(projectRoot, localConfigRoot);
         }
     }
+    if (projectRoot) {
+        return defaultCodeConfigRoot(projectRoot);
+    }
     return path.join(os.homedir(), '.agent-config');
 }
+function defaultCodeConfigRoot(projectRoot) {
+    const resolvedProjectRoot = path.resolve(projectRoot);
+    const ownerDir = path.dirname(resolvedProjectRoot);
+    const codeRoot = path.dirname(ownerDir);
+    if (ownerDir === resolvedProjectRoot || codeRoot === ownerDir) {
+        return path.join(os.homedir(), '.agent-config');
+    }
+    return path.join(codeRoot, 'agent-config');
+}
 function findRealBinary(tool) {
     const pathValue = process.env.PATH || '';
     const pathDirs = pathValue.split(path.delimiter).filter((entry) => entry.length > 0);

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.21",
   "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