beryl

See what your agent understands, and what it doesn’t yet.

While an agent grills you about a plan, beryl draws its model of the design as a live, zoomable board: decisions, assumptions, fog and risks, with every open question lit. Zoom out for the landscape and in for the schema. Answer ahead in your own order, pin a note to a column or a file, and press Send to wake the agent.

Open the demo Install it
Cards on a board, the open ones glowing

Unknowns read loudest

  • Question, open?
    Open question With the agent’s recommended answer.
  • Assumption, open~
    Assumption Taken for granted until you confirm it.
  • Fog, open
    Fog Matters, but is not a question yet.
  • Risk, open!
    Risk What could go wrong if left alone.
  • Question, settled
    Settled Answered; it recedes.
  • Question, parked
    Parked Deliberately deferred.

Install

git clone https://github.com/nvanderploeg/beryl
cd beryl && pnpm install && pnpm build
scripts/install.sh --with-server

This adds the beryl skill and MCP server to your agent and starts a local board on port 3270. Then ask your agent to grill you about a plan; it opens the board for you.