Skip to content

Developer documentation

Everything needed to work on BXP rather than with it. Start with Build — toolchain, repository layout, one command per package — then pick the page for what you are doing.

Working in the repo

  • Build — toolchain setup and how to build each package.
  • Testing — the suite's phases, running one alone, adding a regression or an expression-corpus case.
  • Debugging — which flags to combine, inspecting an expression, driving the live GUI from an agent.
  • Release — version bump, changelog, tag, and what CI builds per platform.
  • Roadmap — planned work by version, and what is deliberately not planned.

How it works

  • Architecture — the bird's-eye topology, the conversion pipeline, the GUI, the live data structures.
  • Internals — design philosophy, the module inventory, implementation notes, performance.
  • GUI internals — the Flutter app's setup, architecture, subprocess wiring and patterns.
  • MCP server — the bxp-mcp tool catalog and wire protocol.
  • Trace protocol — the binary BXTB stream behind --trace, and the shared inspect surface.