Overview
The gk doctor command performs a comprehensive health check of your GemKit installation, verifying all required components are properly configured.
Usage
bash
Options
| Option | Description |
|---|---|
--fix | Attempt to fix detected issues |
Health Checks
The command runs the following diagnostics:
| Check | Description |
|---|---|
| Node.js Version | Verifies Node.js version >= 18 |
| Gemini CLI | Checks if Gemini CLI is installed and retrieves version |
| .gemini Directory | Confirms .gemini directory exists |
| Agents Directory | Validates presence of agents directory |
| Extensions Directory | Validates presence of extensions directory |
| spawn-agent Extension | Checks local extension files exist |
| spawn-agent Installation | Verifies extension is registered in Gemini CLI |
| Installation Metadata | Confirms metadata file exists with version info |
Output
Each check displays a status indicator:
| Symbol | Meaning |
|---|---|
| ✓ | Success - check passed |
| ✗ | Error - critical failure |
| ○ | Warning - non-critical issue |
Example Output
Example with Issues
Auto-Fix
Use --fix to attempt automatic repairs:
bash
This will attempt to:
- Create missing directories
- Install missing extensions
- Register spawn-agent with Gemini CLI
Common Issues
"Gemini CLI not found"
Install Gemini CLI:
bash
"Node.js version too old"
Upgrade to Node.js 18+:
bash
".gemini directory missing"
Initialize GemKit:
bash
Related Commands
gk init- Initialize GemKit- Configuration Reference - Config details