Docs & guide

Everything you need to run your board

The complete command reference and how-to guide for collecting feedback, triaging it, and shipping a roadmap — natively in Telegram and Discord, with a web dashboard for admins.

Step by step

Getting started

Three steps and your community has a working feedback board.

  1. Step 1

    Add the bot

    Invite it to your Discord server or Telegram group. A board is created automatically — no setup wizard.

  2. Step 2

    Members post ideas

    People share requests with /suggest and upvote what they want. In a Telegram DM, plain text becomes a new idea.

  3. Step 3

    Admins manage it

    Triage from chat with admin commands, or run /dashboard for a one-time link into the web dashboard.

For everyone

Member commands

Available to every member of the community — no account required.

Discord uses named options, e.g. /suggest text:… In a Telegram DM, plain text becomes a new idea
CommandWhat it does
/suggestPost a new feature request or idea to the board.
/bugReport a bug as a tracked board item.
/feedbackShare general feedback that admins can triage.
/topSee the most-upvoted suggestions.
/trendingSee ideas gaining votes fastest right now.
/roadmapView what’s planned, in progress, and shipped.
/searchFind existing suggestions before posting a duplicate.
/statsShow board activity and totals.
/mysuggestionsList the suggestions you’ve posted.
/followingList the items you follow for status updates.
/changelogRead what the team has recently shipped.
/comment <id> <text>Add a comment to a suggestion.
/report <id> [reason]Flag a suggestion for an admin to review.
/helpShow the full command list in chat.
For admins

Admin commands

Run these from a community you administer. <id> is the suggestion id shown on each card.

Telegram

Run these in the group — you must be a group admin.

CommandWhat it does
Status buttons on a cardMove a suggestion through Planned / In progress / Done (admin-only).
/reviewShow the queue of suggestions awaiting triage.
/announce <title> | <body>Publish a changelog entry (note the “|” separator).
/merge <sourceId> <targetId>Merge a duplicate into another suggestion.
/delete <suggestionId>Delete a suggestion.
/assign <suggestionId> <telegramUserId|clear>Assign an item to a member (or clear it).
/ban · /unban · /mute · /unmute <telegramUserId>Member moderation.
/warn <telegramUserId> [reason]Warn a member — 3 warns auto-bans.
/unwarn <telegramUserId>Clear a member’s warnings.
/warns <telegramUserId>List a member’s warnings.
/blockword <word> · /unblockword <word> · /blocklistManage the banned-words filter.
/reportsList suggestions members have reported.
/dashboardDM yourself a one-time web-dashboard login link.

Discord

Admin = server owner, or anyone with Administrator or Manage Server.

CommandWhat it does
Status buttons on a cardChange a suggestion’s status (admin-only).
/reviewSuggestions awaiting review.
/announce title:<t> body:<b>Publish a changelog entry.
/merge source:<id> target:<id>Merge duplicates.
/remove id:<id>Delete a suggestion.
/assign id:<id> member:@userAssign to a member (omit member to clear).
/moderate action:<BAN|UNBAN|MUTE|UNMUTE> member:@userMember moderation.
/dashboardGet an ephemeral, one-time web-dashboard login link.
How access works

The admin model

You don’t assign board admins inside the bot — it mirrors the chat’s own admin list.

Community admins — automatic

  • Telegram: the group creator and any administrator gain bot-admin powers for that group’s board.
  • Discord: the server owner, or anyone with Administrator or Manage Server.
  • Telegram DM: each person is the admin of their own personal board.

To add an admin, simply make them an admin of your group or give them Manage Server on Discord — the status buttons and admin commands appear for them automatically. Powers are strictly per-community.

The platform owner

The operator of the whole deployment. They see every community and cross-community analytics in the dashboard’s Platform section, pass every authorization check, and can create back-office sub-accounts scoped to specific communities.

No auto-demote yet

Removing someone’s Telegram/Discord admin does not yet revoke their bot-admin role — it persists until reset manually.

Manage from the web

Web dashboard

Three ways to sign in, then triage everything from one place.

1

Bot magic-link

Run /dashboard in a server or group you admin. The bot sends a private, single-use login link (valid 10 min) — no password.

2

Continue with Discord

Sign in with Discord OAuth from /login. You land scoped to the Discord servers you administer.

3

Email + password

The platform owner’s account — the only sign-in that sees the cross-community Platform section.

What you can do there

  • Triage the review queue, suggestions, and audit log.
  • Move items across the roadmap — reflected in the bots’ /roadmap.
  • Edit community settings and publish changelog entries.
  • Billing: see your plan, upgrade, or open the Stripe portal.
  • Integrations: Slack, Discord, GitHub, Linear, Jira.
  • Exports + scoped API keys, and a shareable public board.
Quick reference

Moderation playbook

Reach for the right tool fast. Every admin action is written to the audit log.

SituationDo this
Spam or abuse from a member/warn (3 = auto-ban), or /ban / /mute.
Repeated bad words/blockword <term> — admins are exempt from the filter.
Duplicate suggestions/merge <dup> <canonical> — votes consolidate.
Off-topic or bad item/delete on Telegram, /remove on Discord.
A member flagged somethingIt appears in /reports — act with the above.
You shipped a feature/announce so it lands in /changelog and notifies followers.
Run it yourself

Self-hosting

The whole stack is yours to host — your data stays on your infrastructure.

Docker ComposeBring your own PostgresBring your own RedisFree local AI

The bot, web dashboard, and API ship as a Docker Compose stack. Supply your own PostgreSQL and Redis, set your Telegram and Discord bot credentials, and bring it up. Deduplication and summaries run on a self-hosted local model by default — zero per-call cost — with OpenAI as an optional upgrade. See the repository’s README for the full setup, environment variables, and operational notes.

Ready to open your first board?

Add the bot in two clicks — your board is live in minutes.