messagingbeginner

Discord helper

A messaging agent wired to a real Discord bot token, answering with a web search behind it. Cheap to run on Haiku. Swap the adapter to telegram (same shape) if that's where your users are instead.

lines 37cost ~$0.005 per response on Haikuapp id discord-helper

Install it locally

# save the YAML below as app.yaml in a new folder
digitorn install ./discord-helper

This is a local install: the folder you create is the source. No Hub package to publish first.

What you get

A live Discord bot, no separate hosting needed
Web search for fresh, cited answers
Per-user credential isolation for the bot token
The same channel shape works for Telegram - just change the adapter

Credentials this template uses

Anthropic Claude

Click each one for the credential setup command, scope guidance, and provider details.

The full YAML, ready to fork

app.yaml

1schema_version: 223app:4  app_id: discord-helper5  name: "Discord helper"6  version: "1.0.0"7  description: "Answers questions right inside a Discord channel."8  category: "communication"910runtime:11  mode: background12  entry_agent: helper1314tools:15  modules:16    web: {}17    channels:18      config:19        providers:20          discord_bot:21            adapter: discord22            credential:23              scope: per_user24              provider: discord25            activation:26              agent: helper2728agents:29  - id: helper30    modules: [{web: [search, fetch]}]31    brain:32      provider: anthropic33      model: claude-haiku-4-534      credential: { ref: anthropic_main, scope: per_user, provider: anthropic }35    system_prompt: |36      Answer concisely. Cite sources.37      Keep responses under 200 words unless asked for detail.

How it works

tools.modules.channels.config.providers

Every inbound channel (cron, webhook, Telegram, Discord, WhatsApp, RSS) is one entry under channels.config.providers, each with an adapter type and an activation block naming the agent it wakes.

credential instead of a token in the YAML

credential: {scope: per_user, provider: discord} tells the runtime to resolve the bot token from the vault at activation time - nothing secret ever sits in app.yaml.

web search for grounded answers

The helper agent gets {web: [search, fetch]}, the real tool names the web module registers, so every answer can cite a live source instead of guessing.

Read the deep dive

10 apps you can ship in 50 lines of YAML

Read article

Newsletter

Get the next post in your inbox.

Engineering notes from the Digitorn team. No marketing, no launch announcements, no "10 prompts that will change your life". Just the things we write that we'd want to read.

Other templates

developerStarter coder/templates/starter-coder developerClaude Code clone/templates/claude-code-clone researchDeep research agent/templates/deep-research developerPull request reviewer/templates/pr-reviewer opsWeekly digest reporter/templates/weekly-digest knowledgeDocumentation generator/templates/doc-writer creativeLive React app builder/templates/react-builder knowledgeKnowledge base agent/templates/knowledge-base-agent opsScheduled data pipeline/templates/data-pipeline