singularity/singularity-forge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
singularity-forge/gitbook/features/remote-questions.md
Jeremy edf9d0be6f docs: add GitBook-ready user-facing documentation 
33 markdown files organized for GitBook import with SUMMARY.md navigation.
Covers installation, core concepts, auto mode, configuration, all providers,
cost management, skills, parallel orchestration, remote questions, teams,
headless CI, and full command reference. User-facing only — no internal/dev content.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-11 10:34:07 -05:00

2.9 KiB
Raw Blame History

Remote Questions

Remote questions let GSD ask for your input via Slack, Discord, or Telegram when running in headless auto mode. When GSD needs a decision, it posts the question to your configured channel and polls for a response.

Setup

Discord

/gsd remote discord

The wizard prompts for your bot token, validates it, lets you pick a server and channel, sends a test message, and saves the config.

Bot requirements:

  • A bot application with a token from the Discord Developer Portal
  • Bot invited to the server with: Send Messages, Read Message History, Add Reactions, View Channel
  • DISCORD_BOT_TOKEN environment variable set

Slack

/gsd remote slack

Bot requirements:

  • A Slack app with a bot token (xoxb-...) from Slack API
  • Bot invited to the target channel
  • Scopes: chat:write, reactions:read, reactions:write, channels:read, groups:read, channels:history, groups:history

Telegram

/gsd remote telegram

Bot requirements:

  • A bot token from @BotFather
  • Bot added to the target group chat
  • TELEGRAM_BOT_TOKEN environment variable set

Configuration

remote_questions:
  channel: discord          # or slack or telegram
  channel_id: "1234567890123456789"
  timeout_minutes: 5        # 1-30, default 5
  poll_interval_seconds: 5  # 2-30, default 5

How It Works

  1. GSD encounters a decision point during auto mode
  2. The question is posted to your channel as a rich message
  3. GSD polls for a response at the configured interval
  4. You respond by:
    • Reacting with a number emoji (1️⃣, 2️⃣, etc.) for single-question prompts
    • Replying with a number, comma-separated numbers, or free text
  5. GSD picks up the response and continues
  6. A ✅ reaction confirms receipt

Response Formats

Single question: React with a number emoji, reply with a number, or reply with free text.

Multiple questions: Reply with semicolons (1;2;custom text) or newlines (one answer per line).

Timeouts

If no response arrives within timeout_minutes, GSD continues with a timeout result — typically making a conservative default choice.

Commands

Command Description
/gsd remote Show menu and current status
/gsd remote slack Set up Slack
/gsd remote discord Set up Discord
/gsd remote telegram Set up Telegram
/gsd remote status Show current config
/gsd remote disconnect Remove configuration

Troubleshooting

Problem Fix
"Remote auth failed" Verify bot token is correct and not expired
"Could not send to channel" Check bot has Send Messages permission; invite bot to channel
No response detected Make sure you're replying to the prompt message, not posting a new one