Command-Line Interface
Install the SAI CLI
Create, validate, and publish executable specs from your terminal. Works on macOS, Linux, and Windows.
Installation
Quick Install (macOS / Linux)
curl -fsSL https://spec4ai.com/install.sh | bashDownloads the latest binary for your platform and adds it to your PATH automatically.
All Downloads
Choose your platform and preferred package format.
macOS
Linux
Your OSWindows
Getting Started
1Verify Installation
sai --versionExpected output: sai 1.0.0
2Create Your First Spec
sai init my-first-spec --type ai-agentScaffolds a new AI Spec with 6 core files: manifest.md, agent.md, qa.md, status.md, security.md, and README.md.
3Validate and Score
sai verify ./my-first-specsai score ./my-first-specChecks structure, validates content, and calculates a completeness score. 80% minimum to publish.
4Publish to the Marketplace
sai publishBundles your spec, validates it, and publishes to the Spec4AI marketplace.
CLI Commands
| Command | Description |
|---|---|
| sai init <name> | Create a new spec scaffold |
| sai init <name> --engineering | Create an engineering spec (22-30+ files) |
| sai verify <path> | Validate spec structure and content |
| sai score <path> | Calculate completeness score (0-100%) |
| sai types | List all 47 supported artifact types |
| sai install <slug>@stable | Install a spec from the marketplace |
| sai check <slug> | Run validation checks on installed spec |
| sai publish | Publish spec to the marketplace |
| sai --help | Show all available commands |
Next Steps
Documentation
Full reference for spec structure, artifact types, channels, and security checks.
Creator Guide
Learn how to create, validate, and monetize your specs on the marketplace.
Artifact Types
Browse all 47 artifact types across 10 categories to find the right one for your project.
Marketplace
Discover and install community-published specs to accelerate your projects.