/env-check - Environment Validation
Validate environment variables, configuration files, and system prerequisites for CODITECT.
System Prompt
EXECUTION DIRECTIVE: When /env-check is invoked, IMMEDIATELY execute the validation script.
Usage
/env-check # Full environment check
/env-check --quick # Quick essential checks only
/env-check --fix # Attempt to fix common issues
/env-check --export # Show exportable env vars
Execution
~/.coditect/scripts/env-check.sh
~/.coditect/scripts/env-check.sh --quick
~/.coditect/scripts/env-check.sh --fix
~/.coditect/scripts/env-check.sh --export
Checks Performed
| Category | Check | Required |
|---|---|---|
| Symlinks | ~/.coditect exists and valid | Yes |
| Symlinks | ~/PROJECTS/.coditect valid | Yes |
| Symlinks | ~/PROJECTS/.claude valid | Yes |
| Config | machine-id.json exists | Yes |
| Config | config.json valid JSON | Yes |
| Config | settings.json valid | No |
| Python | .venv exists and activated | Yes |
| Python | Required packages installed | Yes |
| Database | org.db exists (ADR-118 Tier 2) | Yes |
| Database | sessions.db exists (ADR-118 Tier 3) | Yes |
| Database | platform.db exists (ADR-118 Tier 1) | Yes |
| Database | org.db not corrupted (CRITICAL) | Yes |
| Git | Repository clean | No |
| Git | Remote configured | No |
Output Format
======================================================================
CODITECT Environment Check
======================================================================
Symlinks
--------
[OK] ~/.coditect -> ~/Library/Application Support/CODITECT/core/
[OK] ~/PROJECTS/.coditect -> symlink valid
[OK] ~/PROJECTS/.claude -> .coditect
Configuration
-------------
[OK] machine-id.json exists
[OK] config.json valid JSON
[WARN] cloud_sync.enabled = false
Python Environment
------------------
[OK] .venv exists
[OK] Python 3.11.5
[OK] Required packages: 45/45
Database (ADR-118 Four-Tier)
----------------------------
[OK] org.db exists (233 MB) - Tier 2 CRITICAL
[OK] sessions.db exists (10 GB) - Tier 3
[OK] platform.db exists (45 MB) - Tier 1
[OK] Integrity check passed (all tiers)
Summary: 11/12 checks passed, 1 warning
======================================================================
Exit Codes
| Code | Meaning |
|---|---|
| 0 | All checks passed |
| 1 | Warnings only |
| 2 | Critical failures |
Related Commands
| Command | Purpose |
|---|---|
/health-check | Full system health |
/verify-installation | Installation verification |
/deps-status | Dependency status |
Version: 1.0.0 Created: 2026-01-15 Author: CODITECT Team