▲reactivite
/packages/docs/courses/cli/skillpool/promaster/contact

$ npx promaster --help

~/promaster

promaster

cliv1.6.0

Browse & 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.

view on npm read docs
3
categories
1
github repo
0
bundled content

$ cat install.sh

Install

global

$ npm i -g promaster

no install

$ npx promaster list

$ promaster --features

What It Does

categories[01]

└─ Pick one of three top-level folders — blog, memory, or books — from your content repo.

freshest first[02]

└─ Files are listed newest → oldest, sorted by their last git commit date.

multi-select[03]

└─ Toggle one or more files with space, confirm with enter — no flags to memorize.

local download[04]

└─ Selected files land in ./promaster-data/<category>/, where your app reads them.

any repo[05]

└─ Point it at your own repo via env var, package.json, or the built-in default.

token-aware[06]

└─ An optional GITHUB_TOKEN lifts the rate limit from 60/hr to 5000/hr.

$ ls your-repo/

Three Content Categories

blog
blog/

Long-form posts and articles — the public writing you publish.

memory
memory/

Notes, snippets, and reference material you pull back into context.

books
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. 1. PROMASTER_REPO=owner/repo environment variable
  2. 2. "promaster": { "repo": "owner/repo" } in the directory's package.json
  3. 3. the DEFAULT_REPO constant in src/config.js
$ PROMASTER_REPO=cavid/my-notes promaster list
$ GITHUB_TOKEN=ghp_xxx promaster list

Pull your first batch

// One command lists your Markdown and downloads exactly the files you pick.

npmall packages
  • home
  • packages
  • skillpool
  • docs
  • cli
▲reactivite

// The fastest way to scaffold production-ready React apps. Built by developers, for developers.

$ npm create reactivite@latest

resources/

  • └─ documentation
  • └─ packages
  • └─ cli
  • └─ courses
  • └─ markdown
  • └─ diff
  • └─ run
  • └─ radio
  • └─ tv
  • └─ games
  • └─ about
  • └─ contact

community/

  • └─ github

© 2026 reactivite — all rights reserved