Command Reference
Run scs --help or scs <command> --help for the installed version. Commands
that accept a workspace accept --ws as a short alias for --workspace.
Setup
| Command | Purpose |
|---|---|
scs init | Create directories and starter CSVs |
scs sites | List configured sites |
scs add-site <id> --domain <host> --prefix <PREFIX> | Register a site |
scs ws <name> | Create a workspace (scs <name> also works) |
scs ws --list | List workspaces and record counts |
scs ws <name> --delete [--force] | Archive a workspace |
Pipeline
| Command | Purpose |
|---|---|
scs import-csv --site <id> --ws <name> --source <tool> <file> | Import a keyword export |
scs score --ws <name> | Recompute GOS and gos_tier |
scs research --ws <name> --pid <pid> | Create the research folder |
scs research --ws <name> --pid <pid> --check | Validate research evidence |
scs research --ws <name> --pid <pid> --check --require-export | Also require a file in exports/ |
scs brief --ws <name> --pid <pid> | Render the brief and front matter |
scs brief --ws <name> --pid <pid> --check | Validate the brief half |
scs brief --ws <name> --pid <pid> --approve | Approve a passing brief |
scs sync --ws <name> | Validate, allocate IDs, render Markdown |
scs check [--ws <name>] | Enforce schemas, references, and gates |
scs links check --ws <name> | Validate the internal-link plan |
scs links list --ws <name> | List the internal-link plan |
scs aliases --ws <name> | Generate per-PID aliases |
scs all --ws <name> | check + score + sync + aliases |
Publishing
| Command | Purpose |
|---|---|
scs wp inspect --ws <name> --site <id> | Inspect the ACF/taxonomy contract |
scs wp draft --ws <name> --pid <pid> [--dry-run] | Create or update the draft |
scs wp publish now --ws <name> --pid <pid> | Publish live now (QA gate required) |
scs wp publish <date> --ws <name> --pid <pid> | Schedule a future publish date |
scs wp publish <article.md> | Apply desired state from CSV/front matter |
scs wp status --ws <name> --pid <pid> | Read WordPress state back |
scs wp diff --ws <name> --pid <pid> | Diff local article vs WordPress |
scs wp pull-content --ws <name> --pid <pid> | Save a WordPress review snapshot |
Publishing-state transitions are terminal-controlled:
scs wp draft --ws <name> --pid <pid> --dry-run
scs wp draft --ws <name> --pid <pid>
scs wp publish now --ws <name> --pid <pid>
scs wp publish 2026/12/31 --ws <name> --pid <pid>
scs wp status --ws <name> --pid <pid>
note
scs wp publish now and scheduled publishes require an approved QA snapshot. A
live post is never converted back to draft. Desired state can also be stored in
publishing.csv or article front matter and applied with scs wp publish <article.md>.
Review
| Command | Purpose |
|---|---|
scs qa open --ws <name> --pid <pid> | Print the WordPress edit URL |
scs qa pull --ws <name> --pid <pid> | Read the review gate into publishing.csv |
scs qa check --ws <name> --pid <pid> | Fail unless the review is approved |
scs qa check --ws <name> --pid <pid> --advance | Set Scheduled on pass |
Accepted values
--source:SpyFu,GKP,Writerzen,NeuronWriter,Manual,AI,Other.decision:go,hold,no.status:Discovered,Researched,Selected,Briefed,Writing,Editing,QA,Scheduled,Published,Tracking,Refresh,Consolidated,Pruned,Rejected.kc_type:Topic,Pillar Page,Keyword Cluster,Sub Topic,Supporting.wp_content_format: the target site'scontent_formattaxonomy slug.