Skill

cc-inspect

Install
1
Install the plugin
$
npx claudepluginhub vinhnxv/rune --plugin rune

Want just this skill?

Add to a custom plugin, then install with one command.

Description

Claude Code runtime environment inspector. Comprehensive diagnostic tool that reports all Claude Code environment variables, session identity, config directory, plugin paths, system toolchain versions, Rune runtime state, and platform details. Use when debugging environment issues, verifying session isolation, checking config directory resolution, or diagnosing plugin loading. Trigger keywords: cc inspect, claude code inspect, env check, environment, session id, config dir, diagnostic, runtime info, plugin env, plugin root, system info, toolchain.

Tool Access

This skill is limited to using the following tools:

BashReadGlob
Skill Content

Claude Code Runtime Inspector

Comprehensive diagnostic view of the Claude Code runtime environment, session identity, plugin state, and system toolchain.

Instructions

Run the diagnostic script:

bash "${CLAUDE_PLUGIN_ROOT}/scripts/cc-inspect.sh"

Fallback (outside plugin context):

bash plugins/rune/scripts/cc-inspect.sh

Section Filter

If the user passes --section <name>, only show that section. Valid names: env, session, system, plugin, runtime, echoes, all (default).

JSON Output Mode

If the user passes --json, present findings as structured key-value data.

Environment Variable Reference

Claude Code Core

VariableDescription
CLAUDE_CONFIG_DIRConfig directory override (default: ~/.claude)
CLAUDE_SESSION_IDCurrent session UUID — used for session isolation
CLAUDE_PROJECT_DIRProject root directory
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMSAgent Teams feature flag (1 = enabled)

Plugin System

VariableDescription
CLAUDE_PLUGIN_ROOTAbsolute path to the active plugin directory
CLAUDE_PLUGIN_DATAPlugin-scoped persistent data directory

Rune-Specific

VariableDescription
RUNE_SESSION_IDRune workflow session ID (injected by SessionStart hook)
RUNE_TRACETrace logging toggle (1 = enabled)
RUNE_TRACE_LOGTrace log file path
RUNE_CLEANUP_DRY_RUNDry-run mode for cleanup hooks (1 = log only)

Process & System

VariableDescription
PPIDParent process ID (Claude Code PID — used for session isolation)
HOMEUser home directory
USERCurrent user name
SHELLUser's default shell
TMPDIRTemporary directory (macOS sets this per-session)
PATHExecutable search path (truncated for readability)

What to Report

  1. Session Identity — Session ID, PID, config dir, resolved CHOME
  2. Claude Code Env — All CLAUDE_* variables with set/unset status
  3. Rune Env — All RUNE_* variables
  4. Plugin System — Plugin root, data dir, cache, component counts
  5. System Toolchain — Shell, Node.js, Python, jq, git, gh versions
  6. Platform — OS, architecture, kernel version
  7. Runtime State — Active state files, talisman shards, signals
  8. Echoes — Persistent memory entry counts per role

Troubleshooting

  • CLAUDE_PLUGIN_ROOT / CLAUDE_PLUGIN_DATA not set: running outside plugin context
  • CLAUDE_CONFIG_DIR not set: using default ~/.claude (single-account setup)
  • CLAUDE_SESSION_ID not set: older Claude Code version or non-interactive context
  • PPID mismatch between skill and hook: expected — hooks run via hook runner subprocess
Stats
Stars1
Forks0
Last CommitMar 18, 2026
Actions

Similar Skills