CLI Overview
The Specra CLI lets you create, deploy, and manage your documentation sites from the terminal
CLI Overview
The Specra CLI provides two commands that work together:
create-specra— Scaffold new projects and manage your docs (all-in-one)specra— Management-focused CLI for deploy, auth, and diagnostics
Both commands share the same subcommands. Use whichever you prefer.
Installation
Install globally to use specra and create-specra anywhere:
Or run without installing using npx:
bash
1npx create-specra@latestCommands
| Command | Description |
|---|---|
create-specra init [dir] | Create a new Specra documentation site |
create-specra login | Authenticate with your Specra account |
create-specra logout | Clear stored credentials |
create-specra deploy | Deploy your docs to Specra Cloud |
create-specra projects | List your projects |
create-specra logs <projectId> | View deployment logs |
create-specra doctor | Validate your specra.config.json |
create-specra help | Show help for all commands |
Info
All commands also work with `specra` instead of `create-specra`. For example, `specra login` is the same as `create-specra login`.
Quick Start
Create a new project
bash
1npx create-specra@latest my-docsAuthenticate
bash
1cd my-docs2npx create-specra loginThis opens your browser to authenticate. Your token is saved to the local `specra.config.json` so each project can use a different account.
Deploy
bash
1npx create-specra deployYour docs are packaged and uploaded to Specra Cloud.
Getting Help
Every command supports --help:
bash
1create-specra --help # Show all commands2create-specra login --help # Show login options3create-specra deploy --help # Show deploy options