docs-lookup

name	docs-lookup
description	Look up Buttondown documentation in the local cache before answering API questions or making API calls. Use grep/read against $CLAUDE_USER_DATA/buttondown-mgmt/cache/docs to ground responses in the canonical docs rather than training-data recall.

Docs Lookup

Always consult the cached docs before:

• Answering "how do I X with Buttondown" questions
• Constructing API requests (endpoint, payload shape, auth header)
• Recommending CLI invocations

Steps

DOCS_DIR="${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/buttondown-mgmt/cache/docs"

If $DOCS_DIR is missing or stale (>14 days since docs_last_refresh in config.json), run refresh-docs first.

Search with grep -ril <keyword> "$DOCS_DIR", then Read the most relevant files. Cite file paths in answers so the user can verify.

If the docs do not cover the topic, say so explicitly rather than improvising — and consider whether the upstream docs need a doc-bug report.