cli-anything-codimd/cli_anything/codimd

CodiMD CLI Harness

A stateful CLI for CodiMD - collaborative markdown notes on all platforms.

Installation

pip install cli-anything-codimd

Quick Start

# Set your CodiMD server
cli-anything-codimd config set server https://your-codimd-server.com

# List your notes
cli-anything-codimd note list

# Create a new note
cli-anything-codimd note create --content "# My New Note\n\nHello world"

# Get note content
cli-anything-codimd note get <note-id>

# Export as markdown
cli-anything-codimd export markdown <note-id> --output note.md

# Get user info
cli-anything-codimd user me

Commands

Note Operations

Command	Description
note list	List user's notes
note get <id>	Get note content
note create	Create new note
note update <id>	Update note content
note delete <id>	Delete note
note info <id>	Get note metadata
note publish <id>	Get publish link

User Operations

Command	Description
user me	Get current user info
user login	Login to server
user logout	Logout from session
user export	Export all user data
user delete	Delete user account

Export Operations

Command	Description
export markdown <id>	Export as markdown
export pdf <id>	Export as PDF
export html <id>	Export as HTML
export slide <id>	Export as reveal.js slides

Revision Operations

Command	Description
revision list <id>	List note revisions
revision get <id> <time>	Get note at specific time

Configuration

Command	Description
config get [key]	Get configuration value
config set <key> <value>	Set configuration value

JSON Output Mode

All commands support --json flag for machine-readable output:

cli-anything-codimd --json note list

Response format:

{
  "status": "success|error",
  "data": {...},
  "error": "error message if status is error"
}

Session Management

The CLI stores session data in ~/.config/cli-anything-codimd/:

• session.json: Auth tokens and session data
• config.json: Server configuration

Development

# Install in development mode
pip install -e .

# Run tests
pytest cli_anything/codimd/tests/ -v

# Run with specific command
python -m cli_anything.codimd.codimd_cli --help

License

MIT License