specs use
A one-off command: fetch a template from any source, execute it into <target-dir>, then discard the download. Nothing is saved to the registry. For templates you’ll reuse, use specs template download instead.
specs use github:specsnl/go-service ./new-service
specs use ./local-template ./output --use-defaults
specs use github:specsnl/go-service ./new-service --arg projectName=my-serviceSource formats
| Format | Example |
|---|---|
| GitHub shorthand (default branch) | github:specsnl/go-service |
| GitHub shorthand with branch | github:specsnl/go-service:main |
| GitHub shorthand with tag | github:specsnl/go-service:v1.2.0 |
| Full HTTPS URL | https://github.com/specsnl/go-service |
Full HTTPS URL with .git suffix | https://github.com/specsnl/go-service.git |
| SCP-style SSH URL | git@github.com:specsnl/go-service |
| Explicit SSH URL | ssh://git@github.com/specsnl/go-service |
| Relative local path | ./local-template |
| Absolute local path | /home/user/templates/go-service |
| Explicit local path prefix | file:./local-template |
The GitHub shorthand github:owner/repo:ref accepts any git ref — a branch name, a tag, or a full commit SHA. HTTPS and SSH sources always use the repository’s default branch.
Flags
| Flag | Description |
|---|---|
--values <file> | Load variable values from a JSON or YAML file (.yaml/.yml → YAML, otherwise JSON) |
--arg <key=value> | Set a single variable (repeatable) |
--use-defaults | Accept all defaults without prompting |
--no-hooks | Skip pre/post-use hooks |