Misar IO Docs

CLI

Use the MisarBlog CLI to manage your blog from the terminal

Installation

npm install -g @misar/blog-cli

Or with pnpm:

pnpm add -g @misar/blog-cli

Authentication

misarblog login

You will be prompted to enter your API key (mbk_...). It is stored securely in your system keychain.

Quick Start

# List recent posts
misarblog posts list --username johndoe

# Get a specific post
misarblog posts get johndoe my-first-post

# Generate an embed URL
misarblog embed url johndoe --theme dark

# Publish a markdown file as a post
misarblog posts publish ./my-post.md --title "My First Post"

Commands

Posts

misarblog posts list <username> [--limit <n>] [--page <n>]
misarblog posts get <username> <slug>
misarblog posts publish <file> --title <title> [--tags <tag1,tag2>]
misarblog posts delete <slug>

Embeds

misarblog embed url <username> [--slug <slug>] [--theme light|dark|auto]

Webhooks

misarblog webhooks list
misarblog webhooks create --url <endpoint> --events publish,update,delete
misarblog webhooks delete <id>

Auth

misarblog login          # Set API key
misarblog logout         # Remove stored key
misarblog whoami         # Show current account

Output Formats

# Default: human-readable table
misarblog posts list johndoe

# JSON output (for scripting)
misarblog posts list johndoe --json

# CSV output
misarblog posts list johndoe --csv