README
¶
cws — Chrome Web Store CLI
A single-binary CLI for managing Chrome Web Store extensions. Upload, publish, rollout, and more — from your terminal, powered by the latest V2 API.
Install
brew install null3000/tap/cws
Or via script:
curl -fsSL https://null3000.github.io/cws-cli/install.sh | bash
Or from source:
go install github.com/null3000/cws-cli/cmd/cws@latest
Quick Start
cws init # interactive credential setup
cws validate ./dist # pre-flight checks
cws upload ./dist # validate, zip, and upload
cws publish # publish to the store
Commands
| Command | Description |
|---|---|
cws init |
Interactive credential setup wizard |
cws validate [source] |
Pre-flight validation (manifest, version, size) |
cws upload [source] |
Validate, zip, and upload a package |
cws publish |
Publish the latest uploaded version |
cws status |
Check extension status |
cws rollout <percentage> |
Set deploy percentage (10k+ users required) |
cws cancel |
Cancel a pending submission |
cws version |
Print CLI version |
Validate
Run pre-flight checks before uploading:
cws validate ./dist # full validation (local + remote)
cws validate ./dist --local # local checks only (no credentials needed)
Checks include: manifest.json validity, required fields, version format, package size, version higher than published, and no pending submission.
Validation runs automatically before every cws upload. Use --skip-validate to bypass.
Why cws?
cws |
chrome-webstore-upload-cli |
|
|---|---|---|
| Runtime | Single binary — no dependencies | Requires Node.js + npm |
| API version | Chrome Web Store API V2 | V1 (migration requested) |
| Setup | Interactive cws init wizard |
Manual env var configuration |
| Commands | validate, upload, publish, status, rollout, cancel | upload, publish |
| Pre-upload validation | Built-in — manifest, version, and size checks before upload | None |
| Config | TOML file + env vars + CLI flags | Env vars only |
| CI/CD | Drop in a binary — no npm install step |
Requires Node.js in your CI image |
License
MIT
Documentation
¶
There is no documentation for this package.
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.