/check-environment

name: check-environment
description: "Verify Claude, Codex, and Grok availability plus Director guidance, relay, agents, and skills. Audit optional hooks only when selected. Use after installation or when a native surface misbehaves."
user-invocable: true

Environment Check

Verify your development environment is ready for Director Mode.

---

Checks Performed

1. Director Mode Dependencies

| Tool | Purpose | Check | Required | |------|---------|-------|----------| | git | Version control | `git --version` | Yes | | python3 | Installer, adapters, and relay | `python3 --version` | Yes | | jq | Legacy automation hooks only | `jq --version` | No |

2. CLI versions

claude --version
codex --version
grok --version

Minimum: **2.0.0+**

3. Project-Specific Tools

Auto-detect project type and check relevant tools:

| Project Type | Detected By | Tools to Check | |---|---|---| | Node.js | `package.json` | `node --version`, `npm --version` or `pnpm --version` | | Python | `requirements.txt`, `pyproject.toml` | `python3 --version`, `pip --version` | | Rust | `Cargo.toml` | `rustc --version`, `cargo --version` | | Go | `go.mod` | `go version` | | Java | `pom.xml`, `build.gradle` | `java --version`, `mvn --version` or `gradle --version` |

4. Director Mode Installation

• [ ] `.claude/` directory exists
• [ ] `.claude/skills/` populated (35 skills expected)
• [ ] `.agents/skills/` populated when the Codex adapter is selected
• [ ] `.director-mode/bin/director-relay` is executable
• [ ] `.director-mode/bin/director-open` is executable
• [ ] `.claude/agents/` populated (14 agents expected)
• [ ] `.codex/agents/` and `.grok/agents/` populated for selected adapters
• [ ] no active hooks for the default install
• [ ] optional hooks match the explicitly selected mode and contain no surprise deny/block response
• [ ] `CLAUDE.md` exists

5. Git Status

• [ ] Inside git repository
• [ ] Clean working tree (or note uncommitted changes)

---

Output Format

## Environment Check Results

### Director Mode Dependencies
- [x] git: 2.39.0
- [x] python3: 3.11.0
- [x] jq: 1.7

### Claude Code
- [x] Version: 2.1.201

### Project Tools (Node.js detected)
- [x] node: 20.10.0
- [x] pnpm: 8.12.0

### Director Mode Installation
- [x] .claude/ directory exists
- [x] 35 skills installed
- [x] Cross-CLI guidance and relay installed
- [x] 14 agents installed
- [x] default hook mode: none
- [x] native open launcher installed
- [x] CLAUDE.md exists

### Git Status
- [x] Git repository initialized
- [ ] Warning: 3 uncommitted changes

### Summary
**Status**: Ready

---

Follow-up Actions

| Issue | Action | |-------|--------| | Missing python3 | Install Python 3: `brew install python3` (macOS) or `apt install python3` (Linux) | | Missing jq | Ignore unless legacy `--hooks automation` was explicitly selected | | Missing git | Install git for your OS | | Missing node | Install Node.js LTS: https://nodejs.org | | Old Claude Code | Run `claude update` | | No .claude/ | Run install script: `./install.sh .` | | Unexpected hooks active | Inspect Claude user settings and `grok inspect --json`; Grok may load Claude-compatible hooks | | No CLAUDE.md | Run `/project-init` or `/claude-md-template` |