How it fits
- OpenAI's Codex documentation has a guide, Custom instructions with AGENTS.md. Briefatto Board writes its block to AGENTS.md.
- Vite's guide serves the app on http://localhost:5173 during development, and its build options give
distas the default output folder. board adoptcaptures a running site from URLs, or a build folder with an index page through--root.
Set it up
npx briefatto-board install
# with the Vite dev server running:
npx briefatto-board adopt . --page http://localhost:5173/
# or, after a production build:
npx briefatto-board adopt . --root distAsk Codex to follow the Briefatto Board skill and write DESIGN.md from the captures, then run npx briefatto-board freeze .. You can also install the skill through skills.sh with npx skills add Briefatto/briefatto-board.
What Codex gets
- Your React app's real look, recorded as exact styles from a fresh render.
- A check on every piece.
board checkfails clipped text, small text, unloaded fonts and low contrast. - Versions.
board diff v1 v2shows what changed, andboard statuslists stale pieces.
Questions and answers
Dev server or build folder?
Either. Pass --page URLs for a running dev server, or --root dist for a production build. With a running site, keep it running until freeze.
Does it need my component library?
No. Board captures the rendered pages and computed styles, and the agent reads your CSS variables and theme files when it writes the guide.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.