Prerequisites

Before installing GemKit, ensure you have:

Node.js 18+ installed
Gemini CLI installed (npm install -g @google/gemini-cli)

Global Installation

GemKit is distributed as an npm package. Install it globally using your preferred package manager.

Using npm

bash

npm install -g gemkit-cli

Using yarn

bash

yarn global add gemkit-cli

Using pnpm

bash

pnpm add -g gemkit-cli

Verify Installation

Once installed, verify that GemKit is correctly set up by running the doctor command:

bash

gk doctor

This command performs a comprehensive health check of your GemKit installation.

Expected Output

GemKit Doctor
──────────────────────────────────────────

✓ Node.js version (v20.10.0 >= 18)
✓ Gemini CLI available (v2.1.0)
✓ .gemini directory exists
✓ Agents directory exists
✓ Extensions directory exists
✓ spawn-agent extension files present
✓ spawn-agent registered in Gemini CLI
✓ Installation metadata valid

──────────────────────────────────────────
All checks passed!

Auto-Fix Issues

If gk doctor reports issues, use the --fix flag to attempt automatic repairs:

bash

gk doctor --fix

This will attempt to create missing directories, install missing extensions, and register spawn-agent with Gemini CLI.

Troubleshooting

If you encounter any issues during installation, please check our Troubleshooting Guide or join our Discord Community.