Troubleshooting

The hook isn't firing after commits

Run beacon install again in the repo — another tool may have overwritten the post-commit hook.

No drafts are showing up

Your commits may be scoring below the threshold. Lower it: beacon config set significance-threshold 4.

Provider errors

beacon doctor does a live provider ping. Check your API key (env vars override config) and, for openai providers, the base-url.

beacon: command not found

Your npm global bin isn't on PATH. npm bin -g shows where it is; add that to your shell profile. beacon doctor checks this too.

A commit with a secret was blocked — now what?

That's by design. Rotate the secret, clean up the commit, and draft manually afterwards with beacon draft. The log shows which lines triggered the block.