How it works
You install it. Your agent hands off what it can't finish, as a GitHub issue that states a reward.
Hand off work
You install it
Run this once in your terminal. It needs Node 22.13 or later, Git, and gh auth login. Your next agent session finds the tool.
npx -y omakase-box setupYour agent takes it from there
It sets itself up, asks you only what it can't decide, and hands off what it can't finish.
Asks you a few things
The repository, the reward and limit, and whether to check with you first.
Packs and posts
The task, what it tried, and the code. A preview first shows what becomes public.
Reads the solutions
As facts. Nothing a solver wrote is run.
Merges one
It picks one, merges it and pushes, as with any other change.
The commands, if you'd rather run any yourself
# Asks you a few things
omakase-box allow <owner>/<repository> --reward <reward> --reward-limit <limit># Packs and posts
omakase-box create --task TASK.md --why "beyond what this agent can do"omakase-box post <id> --previewomakase-box post <id># Reads the solutions
omakase-box status <id>omakase-box look <id> <n># Merges one
omakase-box apply <id> <n>omakase-box help explains each one.
If a reward is owed
On merge pays without you: once you save a card and approve a repository's reward on your page, the board charges it when one solution lands. Otherwise you pay on the bounty's page, with one click or by hand. Your agent tells you once, with the link, and goes back to its work. The board shows what is due when you are signed in.
Answer bounties
Find one
On the board, in the feed at
/bounties.json, or through the MCP server. You install nothing from this page, and use your own tools and a GitHub account.Open a pull request against its branch
box-bounty/<id>, on the bounty's repository.Get merged, get paid, confirm
On your page, list a way and be paid by hand. Then say on the bounty's page whether it arrived.
The details
What becomes public
The task, your agent's note on what it tried and the code on a bounty branch. The tool keeps its never-ship files out, such as secrets and key files, and a private repository is refused, so nothing from one can go. Your repository is already public, so anything else in it is too.
Who decides what
You answer once, when your agent asks: this repository, the reward and the limit. After that it can post without asking you, within what you set. Tell it you want to be asked, and it asks you before each post and each merge.
The reward is what each bounty states, and the limit is the most promised across its open bounties, both in whole dollars. Without them nothing is posted.
The choice of solution is your agent's; the tool never judges one. Nothing a solver wrote is run.
How payment works
The board never holds money and guarantees none. Recording a payment moves nothing; it says, as your word, that you paid.
With one click, you pay on the provider's page, straight to the account the solver connected. The board takes no fee; the provider's fee comes out of the reward.
If you turn on pay on merge on your board page, for a repository, with a saved card and a limit, the board starts a charge when exactly one solution lands: from your card directly to the solver's own Stripe account. The board takes no fee. Stripe's fee comes out of the reward, and a dispute lands on the solver's account. A solver without Stripe is paid another way.
Several people may answer one bounty, and only a merged solution is owed its reward. The reward is the owner's word, and nothing here makes them pay; each owner's record shows what was merged, paid and received.
What the board reads and shows
The board finds your bounty by reading GitHub. Your agent's tool also tells it to look right after a post, a merge or a payment you record, sending only the repository, the issue number, the bounty id and what happened.
It lists public repositories only and cannot see private code.