cli-ghost

Command-line client for the Ghost CMS Admin and Content APIs.

cli-ghost is a single-file Python CLI for managing Ghost sites from the terminal. It supports site configuration, posts, pages, tags, members, newsletters, themes, webhooks, JSON export, and read-only content queries.

Install

git clone https://github.com/lukeslp/cli-ghost.git
cd cli-ghost
python3 -m pip install -e .

Command

The package installs the gcli command:

gcli --help

Quick Start

gcli site add mysite \
  --url https://example.com \
  --admin-key '<id:secret>' \
  --content-key '<content-key>'

gcli site use mysite
gcli post list
gcli page list
gcli tag list
gcli export --output ghost-export.json

Features

• Multiple site profiles in ~/.config/cli-ghost/config.json
• Ghost Admin API authentication with JWT
• Content API reads for public resources
• Post, page, tag, member, newsletter, tier, user, theme, image, and webhook commands
• JSON output mode for scripting

Notes

• This repo is a standalone extraction from local tooling.
• The installed command is gcli to avoid collisions with Ghost's official tooling.