init

Initialize OpenSpec in a project or extend an existing configuration.

openspec init [path] [options]

Description

Creates the .openspec directory, AGENTS.md, and project.md. It also invokes the Tool Configurator to set up slash commands and rules for supported AI editors (Claude, Cursor, Windsurf, etc.).

If run in a project that is already initialized, it enters "Extend Mode", allowing you to add configurations for new tools without overwriting existing structures.

Options

  • --tools <tools>: Non-interactive tool selection. Accepts all, none, or a comma-separated list (e.g., claude,cursor).

Supported Tools

OpenSpec can generate configuration files for:

  • Amazon Q Developer
  • Antigravity
  • Auggie (Augment CLI)
  • Claude Code
  • Cline
  • Codex
  • CodeBuddy
  • CoStrict
  • Crush
  • Cursor
  • Factory Droid
  • Gemini CLI
  • GitHub Copilot
  • iFlow
  • Kilo Code
  • OpenCode
  • Qoder
  • Qwen Code
  • RooCode
  • Windsurf