cli-reference

Files (1)

• SKILL.md

SKILL.md (first lines)

# CLI Reference

Upstream: https://github.com/buttondown/cli

## Detect

```bash
command -v buttondown >/dev/null && buttondown --version
```

If not installed, point the user at the upstream README for install instructions (it changes — don't hardcode here).

## Auth (multi-newsletter)

The CLI reads the API key from the env var documented upstream. Pick the right newsletter, resolve its `api_key_ref`, then export:

```bash
DATA_ROOT="${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/buttondown-mgmt"
SLUG="<newsletter-slug>"   # or .default==true entry
REF=$(jq -r ".newsletters.\"$SLUG\".api_key_ref" "$DATA_ROOT/config.json")
export BUTTONDOWN_API_KEY="$(op read "$REF")"
```

Always print which newsletter the env was set for before running CLI commands so the user can catch a wrong-newsletter mistake.

## Usage

Before constructing any CLI invocation, consult the cached docs (`docs-lookup` skill) for current command syntax — the CLI evolves.

Common operations:
- List recent emails / drafts
- Create a draft from a local markdown file in the newsletter's `user_dir`
- Send a draft (confirm first)
- List or export subscribers

From danielrosehill/Claude-Buttondown-Mgmt-Plugin, MIT.

More from danielrosehill/Claude-Buttondown-Mgmt-Plugin