Skip to content

byob 0.3.0 — everything is a plugin

Choose a tag to compare

@github-actions github-actions released this 11 Nov 18:09
· 103 commits to main since this release

byob's built-in features now ship as plugins on the same API anyone gets, and plugins can do far
more than add tools: draw UI, sit in the turn pipeline, run long-lived backends, render artifacts.

Breaking: protocol 13 (open, versioned: major must match, minors and capabilities are
additive from here on). Start fresh — 0.2.x profiles aren't migrated. Old browser tabs are told
to reload.

Plugins can now

  • Draw UI with declarative view trees drawn natively (desktop and browser): a side pane, a
    header status chip, a settings section, cards on tool steps, artifact bodies. Includes a
    virtualized, editable grid. See docs/views.md.
  • Run a backend: a long-lived process (JSON lines; Python helper byob_plugin.py, per-plugin
    venv from python.requirements) or in-tree Rust ("backend": {"native": …}). State stays in
    the process; faults and stderr reach the model so it can fix its own plugin.
    See docs/plugins-backend.md.
  • Hook the turn: before_prompt, before_request, before_tool_call, after_tool_call,
    on_turn_end — observe, change, block.
  • Add artifact types and renderers keyed by content type (native, view tree or web page).
  • Provide workspace environments (Nix/pixi/mise/containers are themselves plugins now).
  • Web views and MCP Apps: HTML panes and cards with a bridge (tools/call through the
    approval gate, model context, theme).

Built-ins are bundled plugins

Prompt, core tools, artifacts, charts, images, markdown, HTML apps, compaction, subagents,
environments, workspace instructions and spreadsheets. Fork any of them to your global plugins
and edit it ("Fork to edit" in Settings → Plugins, or ask byob).

Spreadsheets

A native spreadsheet plugin (IronCalc): .xlsx/.csv/.tsv as editable grids beside the chat, with
tools to describe, read, write, fill, restructure and format sheets; every write recalculates and
reports errors back to the model.

Also

  • Deletes are permanent (chats, artifacts, workspace folders; SQLite secure_delete).
  • Broken plugins can be found, read and fixed from a chat.
  • Settings are grouped into cards.
  • Windows: links open without a shell; Python backends speak UTF-8.
  • Hardening from a full audit: output caps that hooks can't bypass, hidden tools can't be called,
    approval cards reflect hook-rewritten arguments, bounded queues/caches for plugins and views,
    backend crashes detected even when a child holds its pipes, frames over the remote cap degrade
    gracefully instead of vanishing.

Install

cargo install byob (crates.io), or download an archive below: byob-… has the browser UI built in (byob --serve), byob-slim-… doesn't.

Full Changelog: v0.2.1...v0.3.0