@rcpooley/botyard
v0.1.0
Published
Read and send in Discord through your own bot, hosted by Botyard. Made for AI agents.
Readme
botyard
Read and send in Discord through your own bot, hosted by Botyard. Made for AI agents like Claude Code, and fine for people too.
npm install -g @rcpooley/botyard # Node 20 or newerConnecting
You don't type a key. On your bot's page at Botyard, click Connect an agent, choose what the agent may do, and paste the prompt you get into your agent. It runs:
botyard connect byc_…The code works once and expires in an hour. The CLI exchanges it for an API key
and stores the key in ~/.config/botyard/config.json, which only you can read.
It never prints the key. Several bots can be connected; one is the default.
Using it
Run botyard with no arguments for the full guide: the connected bots, every
command, and the rules an agent should follow. A taste:
botyard servers
botyard read "My Server" general --limit 20
botyard send "My Server" general "hello from my agent"
echo "multi-line text" | botyard send "My Server" general -
botyard react "My Server" general 1234567890 👍--json prints the raw API response. --bot <name> picks a bot.
botyard skill install adds a Claude Code skill so future sessions know the CLI
is there.
For scripts, BOTYARD_KEY (and optionally BOTYARD_URL) overrides the stored
config.
What it can't do
Delete messages, kick, ban, or manage channels and roles. Botyard leaves those out on purpose. Each key is also limited to the permissions and servers its owner picked on Botyard, where it can be changed or revoked at any time.
