homerail-install-ops

HomeRail Install Ops

Before acting, apply homerail-shared rules. This pre-publication flow uses a local source checkout or local Git clone, not npm publication.

Local Skill Install

Install HomeRail skills by linking the checkout's skills/homerail-* directories into the target agent skill directory. Prefer symlinks over copies so skill updates follow git pull.

If the source tree is already present, use skills/README.md as the source of truth for Codex and Claude Code install targets. On macOS/Linux:

repo=/path/to/HomeRail

for root in "${CODEX_HOME:-$HOME/.codex}/skills" "$HOME/.claude/skills"; do
  mkdir -p "$root"
  for skill in "$repo"/skills/homerail-*; do
    [ -d "$skill" ] || continue
    name="$(basename "$skill")"
    dst="$root/$name"
    if [ -L "$dst" ]; then
      rm "$dst"
    elif [ -e "$dst" ]; then
      echo "Refusing to replace existing non-symlink skill: $dst" >&2
      continue
    fi
    ln -s "$skill" "$dst"
  done
done

If the user gives a local Git address, clone it first, then install links from the checkout:

git clone <local-homerail-git-url> HomeRail
cd HomeRail

On Windows, use PowerShell directory symlinks when Developer Mode or Administrator permissions allow them. If symlinks are blocked, use a junction as the local fallback; repeat the junction for every skills/homerail-* directory that should be installed:

cmd /c mklink /J "%USERPROFILE%\.claude\skills\homerail-install-ops" "C:\path\to\HomeRail\skills\homerail-install-ops"

After installing or updating skills, ask the user to restart the AI agent session if their agent host only loads skills on startup.

After restart, route user requests to the root skills this way:

• Use homerail-install-ops for first install, update, service startup, provider configuration, and smoke verification. Codex invocation: $homerail-install-ops; Claude Code invocation: /homerail-install-ops.
• Use homerail-dag-ops for running DAGs, monitoring runs, checking handoffs, and writing DAG templates.
• Use homerail-dag-patterns for selecting, composing, instantiating, and validating built-in DAG design patterns.
• Use homerail-cli for command syntax, flags, and evidence commands.
• Use homerail-shared as background rules for all HomeRail operations.