@abeedoo/gho

Minimal CLI for managing Ghost CMS posts, pages, and tags. Zero dependencies.

npm · GitHub

Install

npm install -g @abeedoo/gho

Or use with npx:

npx @abeedoo/gho list posts

Setup

Get your Admin API key from Ghost Admin → Settings → Integrations → Add custom integration.

Configure credentials using any of these methods (checked in priority order):

1. Environment variables

export GHOST_URL=https://your-ghost-site.com
export GHOST_ADMIN_API_KEY=your-id:your-secret

2. --env flag

gho --env /path/to/config list posts

3. .gho file (recommended)

Create a .gho file in your project root:

GHOST_URL=https://your-ghost-site.com
GHOST_ADMIN_API_KEY=your-id:your-secret

Add .gho to your .gitignore — it contains secrets.

4. .env file

Falls back to .env if no .gho file is found:

GHOST_URL=https://your-ghost-site.com
GHOST_ADMIN_API_KEY=your-id:your-secret

Multi-site config

Your .gho file can contain multiple sites using [section] headers:

# Default site (used when no --site flag)
GHOST_URL=https://myblog.com
GHOST_ADMIN_API_KEY=id:secret

[staging]
GHOST_URL=https://staging.myblog.com
GHOST_ADMIN_API_KEY=id:secret

[client-blog]
GHOST_URL=https://client.example.com
GHOST_ADMIN_API_KEY=id:secret

Use with the --site flag:

gho --site staging list posts
gho --site client-blog publish my-post
gho list posts                          # uses default

Commands

List content

gho list posts                    # all posts
gho list posts --status draft     # drafts only
gho list posts --status published # published only
gho list pages                    # all pages

Create a draft

gho draft my-post-slug "My Post Title" content.md

Creates a draft post from a markdown file. If the file starts with # Title, the first line is stripped (the title comes from the argument). If a post with that slug already exists, it's replaced.

Publish / Unpublish

gho publish my-post-slug
gho unpublish my-post-slug

Get post details

gho get my-post-slug

Shows title, status, URL, preview link, tags, and excerpt.

Update content

gho update my-post-slug updated-content.md

Replaces the post content from a markdown file. Preserves title, tags, and status.

Delete

gho delete my-post-slug

List tags

gho tags

Shows all tags with post counts, sorted by usage.

Claude Code Skill

Install gho as a Claude Code skill so Claude can manage your Ghost blog conversationally:

gho install-skill

This copies the SKILL.md to ~/.claude/skills/gho/. After installation, you can use /gho commands in Claude Code or just ask naturally:

• "list my drafts"
• "publish the fence post"
• "draft a new post from drafts/my-post.md"

The skill is also available on community marketplaces:

• Claude Skills Market
• SkillsMP

How It Works

Uses Ghost's Admin API with JWT authentication. The CLI constructs JWTs from your Admin API key using Node's built-in crypto module — no external dependencies.

Posts are created using Ghost's mobiledoc format with a markdown card, which means your markdown is rendered by Ghost's markdown engine (including code blocks, links, images, etc.).

License

MIT — Clifford Meece