Skip to main content

ship-spec init

Interactive setup for Ship Spec in your project.

ship-spec init                    # Interactive setup
ship-spec init --non-interactive  # CI/CD mode (uses env vars)

What it does:

  • Prompts for OpenRouter and Tavily API keys
  • Stores keys securely in the OS keychain (per-project namespace)
  • Creates .ship-spec/ directories: outputs/, planning/, lancedb/, consent.json
  • Updates .gitignore

Directory scaffold:

.ship-spec/
├── project.json
├── outputs/
├── planning/
├── lancedb/
└── consent.json