GSP/specs/versions/0.1/commands.md

GSP Commands 0.1

init

Create a minimal GSP project.

gsp init [path] [--name project-name] [--entry project.entry] [--force]

Generated structure:

project/
  gsp.manifest
  design/
    project.entry.gsp

ai-init

Create AI-facing usage files for a GSP project.

gsp ai-init [--root .] [--agents] [--skill generic|codex] [--all] [--force]

Default output:

README.md
AI_USAGE.md

Optional output:

AGENTS.md
skills/gsp/SKILL.md
.codex/skills/gsp/SKILL.md

version

Print toolkit and protocol versions.

gsp version
gsp version --json

completion

Print or install shell completion scripts.

gsp completion powershell
gsp completion bash
gsp completion zsh
gsp completion fish
gsp completion install powershell

Completion covers subcommands, common flags, enum values, and GSP ids from gsp index --root ..

validate

Validate GSP files and references.

gsp validate [--root .] [--out report.json]

index

Build a stable GSP index.

gsp index [--root .] [--out index.json]

trace

Inspect relation chains from one GSP id.

gsp trace <id> [--root .] [--depth 3] [--out trace.json]

flatten

Expand one GSP id into a flat context.

gsp flatten <id> [--root .] [--depth 3] [--include-type a,b] [--exclude-type a,b] [--out flattened.json]

pack

Create a compact AI context pack.

gsp pack <id> [--root .] [--depth 3] [--budget 12000] [--out context-pack.json]

graph

Generate a relation graph.

gsp graph [id] [--root .] [--depth 3] [--format json|mermaid|md|canvas] [--out graph.json]

Formats:

json      Machine-readable graph.
mermaid   Mermaid graph body.
md        Markdown file with Mermaid block.
canvas    Obsidian JSON Canvas file.

Graph display uses title when present and falls back to id.

stage-check

Check minimum resolution for a stage.

gsp stage-check --stage implement [--root .] [--out stage-report.json]