Behold

Behold is a local-first Markdown workspace for presenting agent work and collecting browser feedback. Its MCP server hosts documents in a persistent local viewer at http://behold.localhost:5173.

Install

Bun 1.3 or newer is required.

bunx @kitlangton/behold setup

Setup detects supported coding agents, installs Behold globally through add-mcp, starts the local viewer, and opens it in your browser. Restart a running agent after setup so it loads the new MCP server.

Select a specific agent when automatic detection is not desired:

bunx @kitlangton/behold setup --agent opencode --no-open

Use

Ask your agent naturally:

Put this architecture proposal in Behold.

The agent can host inline Markdown or an absolute Markdown file, update revisions, and wait for browser comments.

Commands

behold setup
behold doctor
behold start
behold status
behold stop
behold mcp

behold doctor verifies the local runtime and reports which detected agents contain a Behold MCP registration.

Data

Behold stores local documents and runtime metadata in the operating system's user data directory:

• macOS: ~/Library/Application Support/Behold
• Linux: ${XDG_DATA_HOME:-~/.local/share}/behold
• Windows: %LOCALAPPDATA%\Behold

Set BEHOLD_DATA_DIR to override the location. Local documents remain private unless you explicitly publish a frozen snapshot from the browser.

Development

bun install
bun dev
bun run test
bun run typecheck
bun run build

License

MIT