refresh-docs

name	refresh-docs
description	Clone or pull the official Buttondown documentation repository (github.com/buttondown/docs) into the plugin's local cache. The cached docs are the canonical source of truth for any Buttondown API, CLI, or feature question — consult them before answering or making API calls.

Refresh Docs

The cached docs are authoritative. Other sources (training data, web search) may be stale.

Steps

DATA_ROOT="${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/buttondown-mgmt"
DOCS_DIR="$DATA_ROOT/cache/docs"
mkdir -p "$(dirname "$DOCS_DIR")"

if [ -d "$DOCS_DIR/.git" ]; then
  git -C "$DOCS_DIR" pull --ff-only
else
  git clone --depth 1 https://github.com/buttondown/docs "$DOCS_DIR"
fi

After refresh, update docs_last_refresh in $DATA_ROOT/config.json to the current ISO timestamp.

Report: docs path, latest commit SHA + date, file count.