$ npx promaster --help
promaster
cliv1.6.0Browse & download Markdown from a public GitHub repo
> An interactive CLI that pulls Markdown from your own GitHub repo — grouped into blog, memory, and books. Pick a category, multi-select files, and download them into ./promaster-data/. The package ships only the CLI — your content is never bundled into npm.
$ cat install.sh
Install
global
$ npm i -g promasterno install
$ npx promaster list$ promaster --features
What It Does
└─ Pick one of three top-level folders — blog, memory, or books — from your content repo.
└─ Files are listed newest → oldest, sorted by their last git commit date.
└─ Toggle one or more files with space, confirm with enter — no flags to memorize.
└─ Selected files land in ./promaster-data/<category>/, where your app reads them.
└─ Point it at your own repo via env var, package.json, or the built-in default.
└─ An optional GITHUB_TOKEN lifts the rate limit from 60/hr to 5000/hr.
$ ls your-repo/
Three Content Categories
blog/Long-form posts and articles — the public writing you publish.
memory/Notes, snippets, and reference material you pull back into context.
books/Longer documents and book-length Markdown you want on hand.
// One public repo, three top-level folders of .md files. Downloads land in ./promaster-data/<category>/ — fetched at runtime, never bundled into the npm package.
$ history | grep promaster
Command Reference
$ promaster list$ PROMASTER_REPO=cavid/my-notes promaster list$ GITHUB_TOKEN=ghp_xxx promaster list$ cat how-it-works.md
How It Works
promaster never bundles content. At runtime it reads your public GitHub repo, lists the .md files in the chosen category newest → oldest by commit date, and downloads the ones you pick over the GitHub API. Update a post in your repo and the next run sees it — no CLI release required.
# which repo
The source repo is resolved in this order — first match wins:
- 1.
PROMASTER_REPO=owner/repoenvironment variable - 2.
"promaster": { "repo": "owner/repo" }in the directory'spackage.json - 3. the
DEFAULT_REPOconstant insrc/config.js
$ PROMASTER_REPO=cavid/my-notes promaster list$ GITHUB_TOKEN=ghp_xxx promaster listPull your first batch
// One command lists your Markdown and downloads exactly the files you pick.