All shelves / Mods / Workflow
byoa
By plannotator
byoa is a Claude Code workflow mod by plannotator.
Connects Claude Code to BYOA web apps, so an app's chat can start turns in your session and Claude can use the app's tools, with a band naming the apps.
Draws
Install
The marketplace name is byoa.
/plugin marketplace add plannotator/byoa /plugin install byoa@byoa
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 0.1.3
- License
- Apache-2.0
- Repo stars
- 4
- Last change
- 2026-10-26
What it can reach
- Draws in the session
- Reaches the network or an outside service
- Calls another program on this machine
Claude Code 2.1.306 or later, in interactive sessions only; claude -p and Agent SDK hosts get nothing. /byoa connect <address> pairs with a device code you approve on the app's page, and /byoa status and /byoa disconnect <app> manage them. An app connected mid-session can start turns at once; its tool arrives with the next session. Tokens are kept in ~/.byoa/credentials. The author calls the protocol draft 0.1.
The marketplace name is byoa, and it holds only this plugin, the Claude Code connector of the BYOA toolkit. Letting a web app hand work to your own session is why this page files it under workflow. plannotator, by backnotprop, opens Claude's plan in a review UI and sends your annotations back. vibe-annotations, by RaphaelRegnier, hands browser annotations from your localhost app to Claude. This one lets an app you connect start turns in your session, each opening with a line the app cannot forge, and gives Claude one tool per app that goes through your permission rules like any other. The app gets the folder name and git remote, and only its own turns stream back: visible text and tool names.
Demo

What it hooks into
session.startWhen a session startssession.endWhen a session endscommand.runWhen you run its slash command/byoa/model/efforttool.callAround a tool call, where it can hold oneprompt.submitWhen you send a promptturn.startWhen Claude starts a turnturn.stepAt each step of a turnturn.completeWhen a turn endsclassic.NotificationA Claude Code eventui.renderDraws into the sessionAbovePrompt
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/byoaBYOA: connect this agent to web apps
Files
The author's README and source, 9 files. They load when you open them.
Facts
- Author
- plannotator
- Category
- Workflow
- Marketplace
- byoa
- Repo
- plannotator/byoa
- Folder
- connectors/claude-code
- Version
- 0.1.3
- License
- Apache-2.0
- Repo stars
- 4
- Last change
- 2026-10-26
- Language
- TypeScript
- Files
- 46