Initialize a SpecGraph project and start the server. Use when "initialize", "bootstrap", "set up specgraph", "start the server", "init", "get started", or starting fresh with SpecGraph in a new project.
Bootstrap a new SpecGraph project: initialize config, start the server and database, verify health, and guide to constitution setup.
docker info >/dev/null 2>&1 && echo "Docker: ready" || echo "Docker: NOT running — start Docker first"
specgraph --version 2>/dev/null || ./specgraph --version 2>/dev/null || echo "specgraph binary not found — run: task build"
If Docker isn't running, stop and tell the user. SpecGraph needs Docker for Memgraph.
If specgraph isn't on PATH, check for ./specgraph in the current
directory. Use whichever works.
specgraph init
This does three things:
.specgraph.yaml with the project slug (derived from git remote or directory name)specgraph serve)If init reports the server is already running, that's fine — skip to Step 3.
If the service install fails (common in sandboxed environments), start manually:
specgraph serve &
specgraph health
specgraph list
Health should return Status: ok. List should return No specs found.
(clean slate).
Summarize what's running:
.specgraph.yaml with project slugThen check for a constitution:
specgraph constitution show
If no constitution exists, route to /specgraph-constitution:
"No constitution configured yet. The constitution is your project's ground
truth — analytical passes check every spec against it. Let's set one up."
If a constitution exists, offer next steps:
"Ready to go. You can start a new spec with /specgraph-spark or see
what's available with specgraph list."