mdwiki-cli

CLI client for the Markdown Content Service — the Wiki layer of the Karpathy LLM Wiki pattern.

mdwiki is a thin REST wrapper for the Java/Spring Boot service that maintains bidirectional wikilinks, versioned markdown documents, and Obsidian-compatible exports.

Install

pip install mdwiki-cli

Or with uv:

uvx --from mdwiki-cli mdwiki --help

Requires Python 3.11 or newer.

Configure

Either env vars:

export MDWIKI_BASE_URL=http://localhost:8091/hft1
export MDWIKI_TOKEN=dev-admin-token
export MDWIKI_SPACE=wiki              # optional default space

Or ~/.config/mdwiki/config.toml:

base_url = "http://localhost:8091/hft1"
token = "dev-admin-token"
space = "wiki"
timeout = 30

[profiles.prod]
base_url = "https://wiki.prod.example.com/hft1"
token = "prod-token"

Switch profile with MDWIKI_PROFILE=prod. Env vars override TOML.

Quick start

mdwiki ping
mdwiki space ls
mdwiki ls --space wiki
mdwiki cat 42                          # markdown body to stdout
mdwiki context 42 --json               # full context for an agent

cat note.md | mdwiki new --space wiki --title "New" -f -
mdwiki put-content 42 -f revised.md
mdwiki rebuild-links --space wiki

mdwiki export wiki -o /tmp/wiki.zip

Command groups

• space — list / get / new
• documents — cat, show, context, ls, search, new, edit, put-content, versions, get-by-slug
• links — links, backlinks, rebuild-links
• jobs — job-status, job-logs
• export <space> — Obsidian zip
• recent — local history of cat/show
• skill path — bundled SKILL.md absolute path

Run mdwiki <cmd> --help for full options.

Exit codes

Use with Claude Code

After installing the CLI, expose the bundled skill to Claude:

ln -s "$(mdwiki skill path)" ~/.claude/skills/using-mdwiki.md

Claude will then auto-invoke the skill when the user mentions wiki / mdwiki / markdown knowledge base operations.

Develop

git clone <repo>
cd mdwiki-cli
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest

End-to-end tests against a real REST server:

MDWIKI_E2E_BASE_URL=http://localhost:8091/hft1 \
MDWIKI_E2E_TOKEN=dev-admin-token \
pytest -m e2e

Release

# Bump version in pyproject.toml
python -m build
twine upload dist/*

License

MIT.