Give your coding agent eyes and hands.
The session in your terminal is the brain. Beacon is where its plans become visible: features, tables, and endpoints on a canvas you annotate, edit, and approve with one click.
$curl -fsSL https://www.trybeacon.sh/install.sh | shthen run beacon inside any repo
The loop
Propose. Review. Verdict. Repeat.
01
Propose
Ask the session in your terminal to plan a feature. It calls beacon_propose_plan and blocks until you decide. No fire-and-forget.
› plan: magic-link sign-in02
Review
The plan renders as feature nodes, tables, and endpoints. Select any passage to annotate it, mark it for deletion, or edit the boards directly.
/plan · 2 features · 1 table03
Verdict
Approve persists the drafts. Feedback sends your notes back and the agent re-plans. Discard throws it away. Every plan is archived either way.
✓ approved · drafts persistedfeedback sends the agent back to 01 · approval persists the drafts
The surfaces
Everything the agent plans, drawn
/plan
Review
Split screen: the proposal on the left, live canvases on the right. Every plan archived with your decision and a snapshot of the moment.
/map
Roadmap
Features, sub-tasks, and dependencies as a graph. Duplicate features get blocked before they exist.
/db
Database
Proposed tables and endpoints land as drafts, diffed against your live schema: new, changed, or untouched.
Quickstart
Five lines to your first approved plan
$ curl -fsSL https://www.trybeacon.sh/install.sh | sh01 · one binary, nothing to configure$ cd your-repo && beacon02 · registers the repo, opens the panel› /beacon-init03 · maps architecture, schema, roadmap› plan: magic-link sign-in04 · the plan streams onto /plan✓ approve · feedback · discard05 · the verdict returns to your sessionReuse first
Beacon blocks duplicate features. Check the map before you create.
Design data first
Tables and endpoints before code. Review the schema as a draft on /db.
Close every loop
Register finished work so the map stays accurate next session.