@changespage/cli

CLI for changes.page — manage posts from the terminal.

Install

npm install -g @changespage/cli

Setup

chp configure

You'll be prompted to enter your page secret key. Find it in your page settings under Integrations.

Alternatively, use the CHANGESPAGE_SECRET_KEY environment variable or --secret-key flag.

Usage

List posts

chp posts list
chp posts list --status published --limit 5

Get a post

chp posts get <id>

Create a post

Content is read from stdin:

echo "Release notes here" | chp posts create --title "v2.0" --tags new,fix --status draft

Or from a file:

chp posts create --title "v2.0" --tags new,fix --status published < content.md

Update a post

echo "Updated content" | chp posts update <id> --title "v2.1" --tags improvement

Update metadata only (no stdin pipe):

chp posts update <id> --status published

Delete a post

chp posts delete <id>

Options

| Flag | Description | |---|---| | --secret-key <key> | Page secret key | | --pretty | Pretty-print JSON output |

List options

| Flag | Description | |---|---| | --status <status> | Filter by status: draft, published, archived | | --limit <n> | Max number of posts (default: 20) | | --offset <n> | Offset for pagination (default: 0) |

Create / Update options

| Flag | Description | |---|---| | --title <title> | Post title (required for create) | | --tags <tags> | Comma-separated tags: new, fix, improvement, announcement, alert | | --status <status> | draft, published, archived (default: draft) | | --publish-at <date> | ISO date for scheduled publish | | --allow-reactions / --no-allow-reactions | Enable or disable reactions | | --notes <notes> | Internal notes |

License

MIT