Tools
Compare the dashboard, REST API, Node SDK, CLI, and agent skill, then choose the right surface for each publishing step.
Cli Blog gives people and software different ways to work with the same organization, resources, locales, and publishing states. You can mix tools inside one workflow without maintaining a second content model.
Compare the tools
| Tool | Best for | Runs in | Key boundary | Documentation |
|---|---|---|---|---|
| Dashboard | Organization setup, writing, review, members, keys, billing, and activity | Browser with a signed-in session | No API key in the browser | Dashboard and billing |
| REST API | Delivery and content management from any technology | Browsers for public reads; any trusted server for writes | Public key in delivery clients; private key on trusted servers | Resource guides |
| Node SDK | Typed content workflows in JavaScript and TypeScript | Node.js 20+ servers, scripts, CI, and agents | Public or private key according to the operation | Node SDK |
| CLI | Terminal workflows, CI jobs, smoke tests, and JSON automation | A trusted terminal or CI runner | Private key for writes; public key for delivery reads | CLI |
| Agent skill | Reliable tool selection, context, and approval gates | Supported coding and automation agents | The selected API, SDK, or CLI boundary still applies | Agent skill |
Choose by task
| Task | Recommended surface | Alternative |
|---|---|---|
| Invite an editor or change billing | Dashboard | None; these are signed-in organization tasks |
| Render published posts in a browser | REST API with a public key | Your server can proxy and cache the same API response |
| Render published posts in a Node.js server component | Node SDK with a public key | REST API |
| Create a reviewed draft from application code | Node SDK with a private key | REST API |
| Publish from a release job | CLI or Node SDK | REST API |
| Integrate from PHP, Python, Ruby, Go, or Java | REST API | CLI for a separate job |
| Let an agent prepare content | Agent skill plus SDK or CLI | Agent skill plus REST API |
| Review a draft before publication | Dashboard | A custom internal review interface using the API |
| Export or audit every post | Node SDK paginate() or cursor-based REST requests | CLI JSON output |
Follow one shared workflow
A common setup uses all five surfaces:
- An owner creates the organization and scoped keys in the dashboard.
- A coding agent reads the agent skill and uses the Node SDK to prepare a draft.
- An editor reviews the draft and relationships in the dashboard.
- A release job publishes the approved version with the CLI.
- The website reads the published post through the REST API with a public key.
The post ID, slug, locale, status, version, authors, categories, tags, and media stay the same throughout that flow.
Browse resources
The resource guides combine the practical API explanation with links to generated endpoint schemas.
Posts
Create drafts, filter delivery lists, update workflow state, publish, schedule, and delete.
Revisions and redirects
Inspect saved versions and resolve earlier slugs.
Authors
Create and manage public byline profiles.
Categories
Build localized, hierarchical navigation.
Tags
Manage flexible, localized topic labels.
Media
Upload assets and maintain alt text, captions, and metadata.
Locales
List the curated language and region tags available to content.
Sitemap
Generate XML for published, indexable posts.
Feed
Generate RSS XML for published posts.
Shared concepts
These guides apply no matter which programming surface you choose:
API keys
Choose public or private keys, set permissions, rotate credentials, and respond to exposure.
Pagination
Follow cursors efficiently or request exact numbered pages.
Quickstart
Create supporting resources, draft a post, publish it, and deliver it.
Build with AI
Turn agent work into a complete draft, review, approval, and verification flow.
Install package tools
Node SDK:
npm install @cli-blog/nodeCLI:
npm install -g @cli-blog/cliUse the installation guide for local commands and the agent skill guide for supported agent install locations.