Skip to content

hashgraph-online/awesome-codex-plugins / plugins/ClickHouse/loom/skills/loom-status

loom-status

Verified

Use when Loom seems quiet or wrong: a loom tool answers "unauthenticated", "not available" or an empty result for something the user says was saved; the session-start primer did not appear; the user asks "is loom working", "why didn't it remember", "is my token ok", or a Loom hook says `Executable not found in $PATH: "node"` or `node: not found`, or prints a `loom:` line about Node.js 18+. Checks the Node hook runtime, then runs the plugin's client check and reads its lines, so the answer names the cause (missing runtime, unreachable server, rejected or expired token, no writer grant on the write namespace, plugin or MCP entry missing, stranded captures) and the one fix. NOT for server-side operations (that is `loom doctor` on the server) and NOT for deciding what to remember (loom-memory).

FileKindSize
SKILL.mdskill md3.9 KB
reference.mdmarkdown3.9 KB
scripts/ensure-node.shscript7.0 KB

scripts/ensure-node.sh

View on GitHub
#!/bin/sh
# LF line endings only (.gitattributes): sh reads a CR as part of a command.
# Claude Code's hooks run the `node` on its PATH; Codex's run through
# bin/loom-node, which finds Node 18+ on PATH, under a version manager or in
# the usual install directories.
#   ensure-node.sh --check   report only: exit 0 when ready, 1 when missing
#   ensure-node.sh           install Node when missing (root or sudo -n);
#                            exit 2 names what blocks the install
#   ensure-node.sh --path-node   internal: the `node` on PATH is Node 18+
set -eu

# path_node: the `node` on PATH is Node.js 18+; prints the line the launcher's
# --check prints.
path_node() {
  n=$(command -v node 2>/dev/null) || return 1
  v=$("$n" --version 2>/dev/null) || return 1
  m=${v#v}
  m=${m%%.*}
  case $m in '' | *[!0-9]*) return 1 ;; esac
  [ "$m" -ge 18 ] || return 1
  # fnm's per-shell link goes away with the shell: name the directory it points at.
  case $n in
    */fnm_multishells/*)
      if d=$(cd -P "${n%/*}" 2>/dev/null && pwd -P); then
        n=$d/${n##*/}
      fi
      ;;
  esac
  printf 'Loom hook runtime ready: %s (%s)\n' "$n" "$v"
}

# Before any command runs: the Dock check's PATH may hold only Node's directory.
if [ "${1:-}" = '--path-node' ]; then
  path_node
  exit
fi

LAUNCHER="$(dirname "$0")/../../../bin/loom-node"
CLAUDE_SETTINGS="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/settings.json"
SETUP_FILE=''
trap 'if [ -n "$SETUP_FILE" ]; then rm -f "$SETUP_FILE"; fi' EXIT HUP INT TERM

as_root() {
  if [ "$(id -u)" -eq 0 ]; then
    "$@"
  else
    sudo -n "$@"
  fi
}

require_privilege() {
  if [ "$(id -u)" -ne 0 ] && { ! command -v sudo >/dev/null 2>&1 || ! sudo -n true 2>/dev/null; }; then
    echo 'Node is required, but installation needs root or passwordless sudo. Run this helper from a privileged shell.' >&2
    exit 2
  fi
}

download_setup() {
  SETUP_FILE=$(mktemp "${TMPDIR:-/tmp}/loom-node-setup.XXXXXX")
  curl -fsSL --connect-timeout 10 --max-time 120 "$1" -o "$SETUP_FILE"
}

# Claude Code's hooks run the `node` on its PATH. Started from the Dock it has
# no shell profile, only HOME, the system PATH and its settings.json `env`.
gui_check() {
  set -- HOME="$HOME" PATH=/usr/bin:/bin:/usr/sbin:/sbin
  settings=$(sh "$LAUNCHER" -e '
    try {
      const env = require(process.argv[1]).env || {};
      for (const [k, v] of Object.entries(env))
        if (/^[A-Za-z_]\w*$/.test(k) && typeof v === "string" && !v.includes("\n"))
          console.log(`${k}=${v}`);
    } catch {}' "$CLAUDE_SETTINGS" 2>/dev/null)
  while IFS= read -r kv; do
    [ -n "$kv" ] && set -- "$@" "$kv"
  done <<SETTINGS
$settings
SETTINGS
  env -i "$@" /bin/sh "$0" --path-node >/dev/null 2>&1
}

# CLAUDE_PLUGIN_ROOT decides when a caller exports it. Claude Code's Bash tool
# does not, so there the script's own path decides; on Windows that path may
# use backslashes.
claude_code() {
  [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && return 0
  case $0 in */.claude/plugins/* | *'\.claude\plugins\'*) return 0 ;; esac
  [ -n "${CLAUDE_CONFIG_DIR:-}" ] && case $0 in "$CLAUDE_CONFIG_DIR"/plugins/* | "$CLAUDE_CONFIG_DIR"'\plugins\'*) return 0 ;; esac
  return 1
}

# Codex runs its MCP header helper with HOME and PATH, and no LOOM_NODE.
# LOOM_NODE_SYSTEM_DIRS is kept when set, so a test can replace the fixed
# directories both runs search.
codex_helper_check() {
  set -- HOME="$HOME" PATH="$PATH"
  [ -n "${LOOM_NODE_SYSTEM_DIRS+x}" ] && set -- "$@" LOOM_NODE_SYSTEM_DIRS="$LOOM_NODE_SYSTEM_DIRS"
  env -i "$@" sh "$LAUNCHER" --check >/dev/null 2>&1
}

GUI_FIX='set PATH in the env block of '"$CLAUDE_SETTINGS"' to the whole search path with that Node'"'"'s directory first, such as "/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin".'

if [ "${1:-}" = '--check' ]; then
  if claude_code; then
    path_node || {
      if n=$(command -v node 2>/dev/null); then
        echo "loom: the first \`node\` on this PATH, $n ($("$n" --version 2>/dev/null || echo 'no version')), is not Node.js 18+; Claude Code's hooks run that one." >&2
      else
        echo 'loom: no `node` on this PATH; Claude Code'"'"'s hooks run the first one there.' >&2
      fi
      exit 1
    }
  else
    sh "$LAUNCHER" --check || exit 1
  fi
  # On Windows a GUI app gets the user's PATH, and Codex runs no launcher.
  case "$(uname -s)" in Darwin | Linux) ;; *) exit 0 ;; esac
  if claude_code; then
    # A Linux desktop session's PATH already holds /usr/local/bin and the
    # like; only a macOS Dock launch has the bare system PATH.
    [ "$(uname -s)" = Darwin ] || exit 0
    gui_check || echo 'Found only with this shell'"'"'s environment: Claude Code started from the Dock or a desktop launcher finds no Node.js 18+ as `node`. Fix: '"$GUI_FIX"
  else
    codex_helper_check || echo 'The MCP header helper, which Codex runs without LOOM_NODE or a version manager'"'"'s variables, finds no Node. Put that Node'"'"'s directory on the PATH Codex starts with.'
  fi
  exit 0
fi

# ready: the Node this client's hooks run is Node 18+.
ready() {
  if claude_code; then
    path_node
  else
    sh "$LAUNCHER" --check 2>/dev/null
  fi
}

if ready; then
  exit 0
fi

if ! claude_code && [ -n "${LOOM_NODE:-}" ]; then
  echo "LOOM_NODE=$LOOM_NODE is not Node.js 18+, and it wins over any install; fix or unset it." >&2
  exit 2
fi

case "$(uname -s)" in
  Linux)
    require_privilege
    if command -v apt-get >/dev/null 2>&1; then
      if ! command -v curl >/dev/null 2>&1; then
        as_root apt-get update
        as_root apt-get install -y curl
      fi
      download_setup 'https://deb.nodesource.com/setup_22.x'
      as_root bash "$SETUP_FILE"
      as_root apt-get install -y nodejs
    elif command -v dnf >/dev/null 2>&1 || command -v yum >/dev/null 2>&1; then
      pkg=dnf
      command -v dnf >/dev/null 2>&1 || pkg=yum
      if ! command -v curl >/dev/null 2>&1; then
        as_root "$pkg" install -y curl
      fi
      download_setup 'https://rpm.nodesource.com/setup_22.x'
      as_root bash "$SETUP_FILE"
      as_root "$pkg" install -y nodejs
    elif command -v apk >/dev/null 2>&1; then
      as_root apk add --no-cache nodejs
    else
      echo 'Unsupported Linux package manager; install Node.js 18+ on PATH.' >&2
      exit 2
    fi
    ;;
  Darwin)
    if ! command -v brew >/dev/null 2>&1; then
      echo 'Homebrew is needed to install Node.js automatically on macOS.' >&2
      exit 2
    fi
    brew upgrade node || brew install node
    ;;
  *)
    echo 'No installer for this OS; install Node.js 18+ on PATH.' >&2
    exit 2
    ;;
esac

# After an install: Claude Code needs it first on PATH; the launcher says
# itself what it found.
if claude_code; then
  path_node || {
    echo "Node.js was installed, but the first \`node\` on this PATH, $(command -v node || echo none) ($(node --version 2>/dev/null || echo 'no version')), is not Node.js 18+; put Node.js 18+ first on PATH." >&2
    exit 2
  }
else
  sh "$LAUNCHER" --check || exit 2
fi
if claude_code && [ "$(uname -s)" = Darwin ] && ! gui_check; then
  echo 'Claude Code started from the Dock or a desktop launcher still finds no Node.js 18+ as `node`. Fix: '"$GUI_FIX"
fi
echo 'Restart the coding-agent session.'
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 321kUpdated Claude CodeCodexVerifiedInstall