byoi
byoi.app

The command board for your coding agents

Ideas and bugs become cards. Cards become complete instructions, scoped with AI, gated by your review. Any agent executes them and reports back to the board. Everything lives as Markdown in your Git

100% free, no credit card. Your Git, your AI keys

Works with Codex, Claude Code, Cursor, Copilot, Gemini CLI and any other repo-aware agent, no native integration required

The byoi repo on its own board: real cards, written in Portuguese, one column of work ready for agents

How work moves

01

Capture

An idea or a bug becomes a card in seconds

02

Enrich

AI fills scope, criteria and a ready prompt

03

Review

You approve, and a gate flags what is not ready

04

Execute

Any coding agent runs the card under your rules

05

Remember

The board keeps the result and the decisions

Retrieval is not governance

Why not just an AGENTS.md and your harness's memory? Because a harness reads the repo. It finds what is near the task. It cannot know what should be built next, in what order, under which constraints, or whether a task is ready to leave

What your harness already does

  • Reads AGENTS.md and standing rules
  • Finds code and docs near the task
  • Recalls its own previous sessions

What only the board knows

  • Which work exists and what comes first
  • The constraints that apply to this task
  • Whether the handoff passed your review
  • Which paths were tried and rejected

Your AGENTS.md does not go away. It gains a source: the board maintains the rules, context and decisions your agents read

From rough capture to executed card

Every screen below is a real card from the byoi repo. The loop in six moves, with the product on screen

01

Capture

Board, terminal or a public feedback link. Text is enough and a screenshot works too. Nothing else is required for the card to exist

Quick capture: type, pick a type, done
02

Enrich with AI

One click asks your model to fill scope, criteria and missing detail. Every AI touch is logged on the card: which model, which action, how many tokens

AI history on a real card: model, action and token count
03

Generate the handoff

The card compiles into one complete instruction: task, delivery rules, project context. You read it before any agent does

A generated prompt with scope, delivery rules and project context, in plain reviewable text
04

Pass the gate

Before work leaves the board, Byoi flags missing acceptance criteria and conflicts with active decisions. Blockers show up here, not halfway through execution

Context readiness on a real card: one warning, one decision conflict marked as blocking
05

Hand off to any agent

Codex, Claude Code, Cursor or whatever runs in your terminal picks up the card. Your execution policy defines what done means: target column, execution notes, commit mode

The agent execution policy for the byoi repo, versioned in its config
06

The board remembers

The agent moves the card, writes what it did and can register a decision. The timeline is a view of git log, there is no parallel event system

The byoi timeline: AI actions and generated prototypes, each one a commit

A decision made in July still blocks a bad handoff in December

Every decision is a versioned file with an id, a status and the reasoning. New work is checked against active decisions, and a conflict surfaces before the handoff leaves, so a path you rejected stays rejected

Active decisions of the byoi project, each one a Markdown file in Git

Columns, types and tabs are your model, not our features

Prototype and tests are not built-in stages of Byoi. They are two tabs this project chose to have. The board, the card types, the tabs and the collections live in byoi.config.json, versioned like everything else

The applied config: columns, card types, collections and tabs from byoi.config.json
A prototype tab, generated with AI on a real card
A tests tab, an editable checklist another project might not have

The context files most teams write by hand fall out of the flow

Cards, decisions and rules consolidate into versioned context: project, architecture, hard rules, design system, spirit. Agents read them straight from the repo because they are just files

architecture.md open in Byoi: generated, editable and stored as plain Markdown

Point the workspace where you think at the same truth

A Claude Project reading your repo folder starts every conversation already knowing the decisions and constraints. The files that brief your coding agents brief your thinking too

Adding the byoi repo to a Claude Project as knowledge, straight from GitHub

Cancel Byoi and lose nothing

Everything Byoi manages is Markdown and JSON inside your repository. Open the repo without Byoi and it still makes sense

  • Cards, decisions and knowledge are readable files
  • Everything can be edited outside the app
  • Changes review as normal Git diffs
  • No binary blobs, no proprietary format
  • AI runs on your own keys (BYOK), nothing routes through Byoi's account
byoi/cards/byoi/decisions/byoi/knowledge/byoi/context/byoi/byoi.config.json

Built for projects that outlive the chat window

If one chat solves it, you do not need a board. Byoi pays off when the context is worth keeping

Byoi earns its place

  • A solo dev running ongoing products with agents
  • A small technical team that needs one source of intent
  • Several agents working the same repo
  • Parallel projects whose contexts must not blur

Skip it

  • A trivial task a single chat already solves
  • A throwaway script with no tomorrow
  • Fully unattended agents, Byoi keeps a human before every handoff

Byoi is built on Byoi

Every product screen on this page is the byoi repo managed on Byoi: real cards, real decisions, real gate. Some content is in Portuguese because these screens show the product in daily use, not a staged demo. The format you would live in is the one we live in

The projects screen behind this page, with the byoi project on its own board

Put one real project on the board

100% free, no credit card, your Git and your AI keys. If Byoi is not for you, your repo keeps every file anyway