notemd-cli

CLI tool for managing NoteMD (MarkdownBlog) instances with AI agent support.

Features

• 🔌 Connect - Browser-based authentication with auto API key retrieval
• 📝 CRUD Operations - Create, read, update, delete posts
• 🔍 Search - Find existing posts before creating duplicates
• 📦 Skill Installation - Auto-install AI agent skills to multiple directories
• 🏗️ Project-Based - Organize by project/topic, not by session

Installation

npm install -g notemd-cli

Quick Start

# Connect to your NoteMD instance
notemd connect http://localhost:6514

# List posts
notemd list

# Search posts
notemd list --search "project-name"

# Create a post
notemd create "My Project" -c "Initial documentation"

# Append to existing post
notemd append my-project "Additional details..."

# Show post details
notemd show my-project

Commands

| Command | Description | |---------|-------------| | connect <url> | Connect to NoteMD instance | | create <title> | Create new post | | list | List all posts | | show <slug> | Show post details | | append <slug> <content> | Append content to post | | delete <slug> | Delete post | | config | Manage configuration |

Configuration

Connection config stored in ~/.notemd/config.json:

{
  "connections": {
    "default": {
      "url": "http://localhost:6514",
      "apiKey": "mb_live_..."
    }
  }
}

Requirements

• Node.js >= 18.0.0
• NoteMD instance (v1.0.0+)

License

MIT