Skip to content

ginko init

Usage

ginko init [options]

Description

Sets up ginko in your current project directory. Creates the .ginko/ directory for session data, generates CLAUDE.md with AI instructions, and creates docs/ for epics, sprints, and ADRs.

Options

Flag	Description
`--model <model>`	AI model to optimize for: `claude`, `gpt`, `generic`
`--upgrade`	Upgrade AI instructions for an existing project

Examples

# Initialize with defaults
ginko init

# Optimize for Claude Code
ginko init --model claude

# Upgrade existing installation
ginko init --upgrade

What gets created

Path	Purpose
`.ginko/`	Session data, config, event logs
`.ginko/config.json`	Project configuration (gitignored)
`CLAUDE.md`	AI assistant instructions
`docs/`	Epics, sprints, ADRs

ginko create — Create a new project with ginko
ginko charter — Define project goals
ginko config — Manage configuration