| name | cc-inspect |
| 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.
Note: This skill uses disable-model-invocation: true because it is
a diagnostic tool meant for explicit user invocation only.
It appears in the /rune:cc-inspect routing table entry.
|
| user-invocable | true |
| disable-model-invocation | true |
| allowed-tools | Bash, Read, Glob |
| argument-hint | [--json] [--section <name>] |
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 "${RUNE_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
| Variable | Description |
|---|
CLAUDE_CONFIG_DIR | Config directory override (default: ~/.claude) |
CLAUDE_SESSION_ID | Current session UUID — used for session isolation |
CLAUDE_PROJECT_DIR | Project root directory |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS | Agent Teams feature flag (1 = enabled) |
Plugin System
| Variable | Description |
|---|
CLAUDE_PLUGIN_ROOT | Absolute path to the active plugin directory (hook context only) |
RUNE_PLUGIN_ROOT | Bridged plugin root path (available in Bash() tool calls via CLAUDE_ENV_FILE) |
CLAUDE_PLUGIN_DATA | Plugin-scoped persistent data directory |
Rune-Specific
| Variable | Description |
|---|
RUNE_SESSION_ID | Rune workflow session ID (injected by SessionStart hook) |
RUNE_TRACE | Trace logging toggle (1 = enabled) |
RUNE_TRACE_LOG | Trace log file path |
RUNE_CLEANUP_DRY_RUN | Dry-run mode for cleanup hooks (1 = log only) |
Process & System
| Variable | Description |
|---|
PPID | Parent process ID (Claude Code PID — used for session isolation) |
HOME | User home directory |
USER | Current user name |
SHELL | User's default shell |
TMPDIR | Temporary directory (macOS sets this per-session) |
PATH | Executable search path (truncated for readability) |
What to Report
- Session Identity — Session ID, PID, config dir, resolved CHOME
- Claude Code Env — All
CLAUDE_* variables with set/unset status
- Rune Env — All
RUNE_* variables
- Plugin System — Plugin root, data dir, cache, component counts
- System Toolchain — Shell, Node.js, Python, jq, git, gh versions
- Platform — OS, architecture, kernel version
- Runtime State — Active state files, talisman shards, signals
- Echoes — Persistent memory entry counts per role
Troubleshooting
CLAUDE_PLUGIN_ROOT / CLAUDE_PLUGIN_DATA not set: running outside plugin context (hook context)RUNE_PLUGIN_ROOT not set: SessionStart hook failed to inject (check CLAUDE_ENV_FILE)CLAUDE_CONFIG_DIR not set: using default ~/.claude (single-account setup)CLAUDE_SESSION_ID not set: older Claude Code version or non-interactive contextPPID mismatch between skill and hook: expected — hooks run via hook runner subprocess
