ecto

# ecto - Ghost.io Admin API CLI Manage Ghost.io blogs via the Admin API. Supports multi-site configuration, markdown-to-HTML conversion, and JSON output for scripting. ## Quick Reference ### Authentication ```bash ecto auth add <name> --url <ghost-url> --key <admin-api-key> ecto auth list ecto auth default <name> ecto auth remove <name> ``` Environment overrides: `GHOST_URL`, `GHOST_ADMIN_KEY`, `GHOST_SITE` ### Posts ```bash ecto posts [--status draft|published|scheduled|all] [--limit N] [--json] ecto post <id|slug> [--json] [--body] ecto post create --title "Title" [--markdown-file file.md] [--stdin-format markdown] [--tag tag1,tag2] [--status draft|published] ecto post edit <id|slug> [--title "New Title"] [--markdown-file file.md] [--status draft|published] ecto post delete <id|slug> [--force] ecto post publish <id|slug> ecto post unpublish <id|slug> ecto post schedule <id|slug> --at "2025-01-25T10:00:00Z" ``` ### Pages ```bash ecto pages [--status draft|published|all] [--limit N] [--json] ecto page <id|slug> [--json] [--body] ecto page create --title "Title" [--markdown-file file.md] [--status draft|published] ecto page edit <id|slug> [--title "New Title"] [--markdown-file file.md] ecto page delete <id|slug> [--force] ecto page publish <id|slug> ``` ### Tags ```bash ecto tags [--json] ecto tag <id|slug> [--json] ecto tag create --name "Tag Name" [--description "desc"] ecto tag edit <id|slug> [--name "New Name"] [--description "desc"] ecto tag delete <id|slug> [--force] ``` ### Images ```bash ecto image upload <path> [--json] ``` ### Site Info ```bash ecto site [--json] ecto settings [--json] ecto users [--json] ecto user <id|slug> [--json] ecto newsletters [--json] ecto newsletter <id> [--json] ``` ### Webhooks ```bash ecto webhook create --event <event> --target-url <url> [--name "Hook Name"] ecto webhook delete <id> [--force] ``` Events: `post.published`, `post.unpublished`, `post.added`, `post.deleted`, `page.published`, etc. ## Multi-Site Use `--site <name>` to target a specific configured site: ```bash ecto posts --site blog2 ``` ## Common Workflows Create and publish from markdown: ```bash ecto post create --title "My Post" --markdown-file post.md --tag blog --status published ``` Pipe content from stdin: ```bash echo "# Hello World" | ecto post create --title "Quick Post" --stdin-format markdown ``` Schedule a post: ```bash ecto post schedule future-post --at "2025-02-01T09:00:00Z" ``` Batch publish drafts: ```bash for id in $(ecto posts --status draft --json | jq -r '.posts[].id'); do ecto post publish "$id" done ``` ## Limitations - Ghost API does not support listing images or webhooks - Member/subscription management not available via Admin API - Read-only access to users ## Full Docs Run `ecto --ai-help` for comprehensive documentation.