ClaudeCodeMod

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.

In Claude Code
/plugin marketplace add plannotator/byoa
/plugin install byoa@byoa
Open the repo

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

The Use and What connecting grants sections of the byoa connector README: /byoa connect, status, and disconnect; connect pairs with a device code you approve on the app's own page, and the band above the prompt names the connected apps or shows the code while a pairing waits; a connected app can start turns in your interactive sessions, each opened by a line it cannot forge, and Claude can use the app's tools as you, through your permission rules.
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • session.endWhen a session ends
  • command.runWhen you run its slash command/byoa/model/effort
  • tool.callAround a tool call, where it can hold one
  • prompt.submitWhen you send a prompt
  • turn.startWhen Claude starts a turn
  • turn.stepAt each step of a turn
  • turn.completeWhen a turn ends
  • classic.NotificationA Claude Code event
  • ui.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

Other mods in Workflow

ultrapowerspopmechanicOpens an intent tray beside the chat when Claude has a screen for you, to pick a version and add notes, with a band of Add note, Send, and Clear buttons.olefolef-devShows the Android device and the last build in the status line, with toasts for a crash or failed request, beside a live device viewer Claude opens for you.harness-scopeshimo4228Holds a commandTurns your global skills, agents, rules, and tools on or off per repo by a profile the repo names, refuses calls to what is off, and says so on the status line.flysuperflyHolds a commandOpens a read-only Sprite Inspector pane over the Fly connection, beside Fly MCP tools for apps, Machines, secrets, and Postgres, and asks before risky calls.spritessuperflyHolds a commandOpens a read-only Sprite Inspector pane for your remote Sprites, their services, checkpoints, and logs, with Use in chat to point Claude at one.catalog-paneT-AI-LabsOpens a /catalog pane of every skill, command, agent, mod, plugin, hook, MCP server, and tool, with usage, token cost, and buttons to run or manage each one.issuesHula-Hoop-AIOpens an /issues pane of the open issues assigned to you on GitHub, Linear, Jira, and monday.com, and a press puts an issue's key and link in your prompt.observeHula-Hoop-AIOpens an /observe pane of your Docker and Modal containers with live logs and GPU, CPU, and RAM meters, and your Render and Vercel deploys.grilltheonly1meAsks three to five questions about your task, one at a time above the prompt while Claude works, and puts each answer into Claude's running turn.mokkanvicmpenHolds a commandDocks a reminder list in a pane beside the transcript, synced through the author's server to every session, and refuses accept and delete-account from Claude.env-tabsahmtsahinDraws a Projects pane in the desktop app's Code tab with your pinned projects on top and live session dots, plus a tab above the prompt for each pinned project.modmgrayagmarOpens /mods to search mods on GitHub and in your marketplaces, shows what each can reach before it installs, and installs, turns off, updates, or removes them.
All 396 in Workflow