Skip to content

/gsd init

The first command to run in a new project. init detects your project’s language, framework, and tooling, then creates the .gsd/ directory with the appropriate configuration. If an existing GSD project is detected, it offers reinitialisation options.

/gsd init

The wizard runs interactively — no arguments needed.

  1. Detects project state — scans for package.json, Cargo.toml, go.mod, pyproject.toml, etc. to identify your language and framework
  2. Configures preferences — sets up isolation mode, model preferences, and project-specific settings
  3. Bootstraps .gsd/ — creates the directory structure including PROJECT.md, REQUIREMENTS.md, DECISIONS.md, KNOWLEDGE.md, and STATE.md

If GSD is already initialised, the wizard detects this and offers options to reinitialise or update the configuration.

  • /gsd setup — configure global settings (LLM auth, search, remote integrations)
  • /gsd doctor — diagnose issues with an existing GSD project