Quick Start

1. Install Prerequisites

Install Gemini CLI and GemKit CLI globally:

npm install -g @google/gemini-cli
npm install -g gemkit-cli

2. Initialize Your Project

Navigate to your project directory and run:

gk init

This creates the .gemini folder structure with agents, commands, extensions, and hooks.

3. Configure Your API Key

Ensure your Gemini API key is set in your environment:

# Windows
setx GEMINI_API_KEY "your_key_here"

# macOS/Linux
export GEMINI_API_KEY="your_key_here"

4. Spawn Your First Agent

Use the Researcher agent to test your setup:

gk agent spawn -a researcher -p "Analyze the project structure"

You can also search for the best agent and skill combination for a task:

gk agent search "implement user authentication"

5. Start the Agent Office

Visualize your agents in action with the gamified dashboard:

gk office start --port 4000

This launches a web dashboard at http://localhost:4000.

6. Check Your Session

View your current session details:

gk session status

Next Steps

• Explore the CLI Reference for more commands.
• Learn about Kits & Agents.
• Join our Discord for help and discussion.