Thread Management Directions¶

When and how to use conversation threads — decision guide, response types, behavioral notes

When to use¶

user wants to start a conversation thread, or agent needs to explain a plan, ask multi-step questions, or send progress updates

Slash command: /wb-thread

threads/thread_create
threads/thread_send
threads/thread_ask
threads/thread_poll
threads/thread_close
threads/thread_list

Directions¶

Start or manage a conversation thread with the user via the dashboard sidebar.

Argument: $ARGUMENTS (optional -- thread_id to resume, or blank to create new)

Thread operations¶

mcp__work-buddy__wb_run("thread_create", {"title": "...", "message": "..."}) mcp__work-buddy__wb_run("thread_send", {"thread_id": "...", "message": "..."}) mcp__work-buddy__wb_run("thread_ask", {"thread_id": "...", "question": "...", "response_type": "boolean"}) mcp__work-buddy__wb_run("thread_poll", {"thread_id": "..."}) mcp__work-buddy__wb_run("thread_close", {"thread_id": "..."}) mcp__work-buddy__wb_run("thread_list")

When to use threads¶

Explaining plans before executing: create thread, describe plan, ask approval
Multi-step decisions: ask a sequence of questions in one conversation
Progress updates: send status messages during long tasks
Follow-up conversations: when a notification needs back-and-forth

Response types for thread_ask¶

Type	User sees	Response value
freeform (default)	Text input	User's text
boolean	Yes/No buttons	"true" or "false"
choice	Labeled buttons	The choice key

Behavior¶

thread_create opens the chat sidebar on dashboard automatically
thread_ask with timeout_seconds blocks until response (max 110s)
thread_poll checks latest question without sending a new message
Sidebar auto-polls every 3s for new messages