Syncally Discord Bot

Discord bot that allows users to ask questions about their codebase, meeting, project, tasks, etc directly from Discord.

Features

• /ask command to query your codebase
• Smart context classification
• File references in responses
• Error handling with user-friendly messages

Setup

1. Install Dependencies

npm install

2. Configure Environment

Copy .env.example to .env and fill in:

DISCORD_BOT_TOKEN=your_bot_token
DISCORD_CLIENT_ID=your_client_id
SYNCALLY_API_URL=https://syncally.app/api/integrations/query

3. Deploy Commands

npm run deploy-commands

4. Start Bot

Development

npm run dev

Production

npm run build
npm start

Commands

• /ask <question> - Ask a question about your codebase

Development

npm run dev # Start with hot reload
npm run build # Build TypeScript
npm run start # Start production build

Deployment

See DEPLOYMENT.md for deployment instructions. Part 5: Testing & Running Step 1: Setup Environment

# Copy environment template

cp .env.example .env

# Edit .env with your values

nano .env

Step 2: Deploy Commands

```bash
npm run deploy-commands

Expected output:

Started refreshing 1 application (/) commands. Successfully reloaded 1 application (/) commands. Step 3: Start Bot

npm run dev

Expected output:

[2025-12-08T12:51:00.000Z] [INFO] ✅ Syncally bot logged in as Syncally Bot#1234 [2025-12-08T12:51:00.000Z] [INFO] 📊 Connected to 1 servers Step 4: Invite Bot to Server Use the OAuth2 URL you generated in Discord Developer Portal:

https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=277025409088&integration_type=0&scope=bot+applications.commands