gk new

Overview

The gk new command creates a new GemKit project by downloading and extracting the latest starter kit from GitHub.

Usage

gk new <name>

Arguments

What It Does

1. Validates - Checks if directory already exists
2. Downloads - Fetches latest starter kit release from GitHub
3. Extracts - Unpacks the starter kit to your new project directory
4. Reports - Shows next steps to get started

Example

# Create a new project called "my-app"
gk new my-app

# Output:
# ✓ Created project: my-app
#
# Next steps:
#   cd my-app
#   gk init

After Creating a Project

Navigate to your new project and initialize GemKit:

cd my-app
gk init

This sets up the .gemini/ directory with:

• Agents (code-executor, planner, researcher, tester)
• Commands (/cook, /code, /test)
• Extensions (skills)
• Hooks

Error Handling

The command will exit with an error if:

• Directory with the specified name already exists
• Cannot fetch the latest starter kit from GitHub
• Archive extraction fails

Difference from gk init

Use gk new when starting a fresh project.

Use gk init when adding GemKit to an existing codebase.

Related Commands

• gk init - Initialize GemKit in existing project
• gk doctor - Verify setup after initialization