Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (buffalo-projects) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

buffalo-projects

The Buffalo Projects CLI. Scan a codebase for the projects you've built, log work, and keep your public Buffalo work page current — from the terminal.

Free and open source (MIT). Buffalo Projects is the work page Buffalo college builders send: a page at /b/[handle] that auto-populates from your terminal, your AI co-pilot, and GitHub.

Install

# one-off
npx -y buffalo-projects@latest scan

# or install the `buffalo` command globally
npm i -g buffalo-projects@latest

Requires Node 18+.

Quickstart

buffalo login                 # device-code login in your browser
buffalo scan                  # detect projects in the current repo, pick which to add
buffalo log "shipped X"       # log one shipped thing to your work page

`buffalo scan`

Detects the distinct efforts in a codebase (monorepo packages, standalone tools, subprojects), then lets you choose which to add to your page. It reflects what you built — it does not judge the quality of your work. Candidates are ranked by recency/activity only; you curate use / skip / never. Chosen projects are created link-only (you publish explicitly later).

buffalo scan                  # interactive checklist
buffalo scan --dry-run        # preview candidates, write nothing
buffalo scan --yes            # non-interactive: add all detected projects
buffalo scan --json           # machine-readable output

The never choices are remembered (locally in .buffalo/ignore.json and synced to your account) so they don't reappear on future scans.

Commands

buffalo login
buffalo scan      [--days <n>] [--dry-run] [--yes] [--json]
buffalo log       <what you shipped> [--note <text>] [--project <id>]
buffalo init      [--template <type>]
buffalo new       --from <example-id>
buffalo lint      [project.md]
buffalo add       evidence <file-or-url> [--caption <text>]
buffalo add       milestone <title> [--note <text>]
buffalo capture   [--days <n>] [--accept <id,id|all>]
buffalo preview
buffalo push | pull | diff | status | ci | config | examples

Add --json to any command for scriptable output.

Auth

buffalo login stores a token in your OS keychain (falling back to ~/.config/buffalo/config.toml). You can also set BUFFALO_TOKEN and BUFFALO_BASE_URL in the environment.

License

MIT — see LICENSE.