gk init

Description

The gk init command sets up the GemKit directory structure and configuration files in your current project. This creates the foundation for AI-assisted development with specialized agents, skills, and hooks.

Usage

gk init

Or run without global installation using npx:

npx gemkit-cli init

What It Creates

When you run gk init, the following structure is created:

your-project/
├── .gemini/
│   ├── agents/           # Agent definitions
│   │   ├── code-executor.md
│   │   ├── planner.md
│   │   ├── researcher.md
│   │   └── tester.md
│   ├── commands/         # Slash commands
│   │   ├── code.toml
│   │   ├── cook.toml
│   │   ├── test.toml
│   │   └── paste/
│   ├── extensions/       # Skills/knowledge packages
│   │   ├── backend-development/
│   │   ├── frontend-design/
│   │   ├── frontend-development/
│   │   ├── multimodal-io/
│   │   ├── planning/
│   │   ├── research/
│   │   ├── spawn-agent/
│   │   └── testing/
│   ├── hooks/            # Lifecycle hooks
│   │   ├── gk-session-init.cjs
│   │   ├── gk-session-end.cjs
│   │   ├── gk-scout-block.cjs
│   │   └── gk-dev-rules-reminder.cjs
│   ├── .gk.json          # GemKit configuration
│   ├── .gkignore         # Files to ignore
│   └── settings.json     # Settings
└── ... your existing project files

Components Overview

Agents

Four specialized agents are included:

Commands

Three workflow commands are available:

Skills (Extensions)

Eight domain-specific knowledge packages:

• backend-development - Node.js, APIs, databases, security
• frontend-development - React, TypeScript, modern patterns
• frontend-design - UI/UX, CSS, animations
• testing - Vitest, Jest, Playwright, coverage
• research - Technical investigation methodology
• planning - Task breakdown and organization
• spawn-agent - Agent orchestration with BM25 search
• multimodal-io - Image and video handling

Hooks

Lifecycle hooks for automation:

• gk-session-init - Runs when a session starts
• gk-session-end - Runs when a session completes
• gk-scout-block - Security guardrails
• gk-dev-rules-reminder - Development rules enforcement

Examples

Initialize a default project:

cd your-project
gk init

Verify the setup:

gk doctor

List available agents:

gk agent list

After Initialization

Once initialized, you can:

1. Spawn agents for development tasks:

   bash

   gk agent spawn -a code-executor -p "Add user authentication"
   

2. Use slash commands in your prompts:

   bash

   gk agent spawn -p "/cook implement a dark mode toggle"
   

3. Start the Agent Office for visualization:

   bash

   gk office start
   

Related Commands

• gk agent - Manage and spawn agents
• gk doctor - Diagnose setup issues
• gk office - Visual dashboard
• Getting Started Guide - Full tutorial