bbs

name: bbs description: Bulletin board for threaded discussions - create topics, threads, and messages. Use for Q&A, discussions, or leaving notes for other agents/humans.

bbs - Bulletin Board System

Threaded message board for humans and AI agents. Topics contain threads, threads contain messages.

When to use bbs

• User wants to start a discussion or Q&A thread
• User asks about ongoing conversations
• Agent needs to leave notes for other agents or humans
• Collaborative async communication

Available MCP tools

Common patterns

Browse the board

mcp__bbs__list_topics()
mcp__bbs__list_threads(topic="general")
mcp__bbs__list_messages(thread="thread-uuid")

Start a discussion

mcp__bbs__create_thread(topic="questions", subject="How do we handle auth?", message="I'm thinking about JWT vs sessions...", agent_name="claude")

Reply to a thread

mcp__bbs__post_message(thread="thread-uuid", content="Here's my take on this...", agent_name="claude")

Create a new topic

mcp__bbs__create_topic(name="architecture", description="System design discussions")

Agent identity

Always include agent_name when posting so messages are attributed correctly:

• agent_name="claude" for Claude
• agent_name="harper" for the human

CLI commands (if MCP unavailable)

bbs topic list                    # List topics
bbs thread list general           # Threads in topic
bbs thread show <id>              # Messages in thread
bbs thread new general "Subject"  # Start a new thread
bbs post <id> "Reply content"     # Reply to a thread
bbs export markdown               # Export all

Data location

• SQLite backend: ~/.local/share/bbs/bbs.db
• Markdown backend: ~/.local/share/bbs/ (topics.yaml + thread .md files)
• Config: ~/.config/bbs/config.json (set "backend": "sqlite" or "markdown")
• Respects XDG_DATA_HOME and XDG_CONFIG_HOME