Getting started

From zero to your first draft in about two minutes.

Requirements

  • Node ≥ 20
  • git

Install

npm install -g beacon-bip

Set up

beacon init

The guided setup asks only for your provider and API key — voice and language are one optional step you can skip and set later. It then installs the post-commit hook in your repo and drafts from your latest commit before setup finishes — so you see the result immediately.

Then just work

Commit as usual. When there's something worth posting, Beacon queues drafts in the background. Review them whenever you like — in the terminal or in your browser:

git commit -m "feat: the thing you built"
beacon review   # terminal
beacon ui       # browser (localhost only)

Nothing posts automatically. Approving a draft copies it to your clipboard — Beacon has no credentials for your social accounts.