customize

name	customize
description	Add new capabilities or modify Gandalf behavior. Use when user wants to add channels (Telegram, Slack, email input), add integrations, modify the router, or make any other customizations. This is an interactive skill that asks questions to understand what the user wants.

Gandalf Customization

This skill helps users add capabilities or modify behavior. Use AskUserQuestion to understand what they want before making changes.

Workflow

1. Understand the request - Ask clarifying questions
2. Plan the changes - Identify files to modify
3. Implement - Make changes directly to the code
4. Test guidance - Tell user how to verify

Key Files

File	Purpose
src/config.ts	Runtime settings and directories
src/index.ts	Message routing, WhatsApp connection, agent invocation
src/db.ts	Database initialization and queries
src/types.ts	TypeScript interfaces
src/whatsapp-auth.ts	Standalone WhatsApp authentication script
.mcp.json	MCP server configuration (reference)
groups/CLAUDE.md	Global memory/persona

Common Customization Patterns

Adding a New Input Channel (e.g., Telegram, Slack, Email)

Questions to ask:

• Which channel? (Telegram, Slack, Discord, email, SMS, etc.)
• Same memory hierarchy or separate?
• Should messages from this channel go to existing groups or new ones?

Implementation pattern:

1. Find/add MCP server for the channel
2. Add connection and message handling in src/index.ts
3. Store messages in the database (update src/db.ts if needed)
4. Ensure responses route back to correct channel

Adding a New MCP Integration

Questions to ask:

• What service? (Calendar, Notion, database, etc.)
• What operations needed? (read, write, both)
• Which groups should have access?

Implementation:

1. Add MCP server to the mcpServers config in src/index.ts
2. Add tools to allowedTools array
3. Document in groups/CLAUDE.md

Changing Assistant Behavior

Questions to ask:

• What aspect? (name, persona, response style)
• Apply to all groups or specific ones?

Simple changes → edit src/config.ts Persona changes → edit groups/CLAUDE.md Per-group behavior → edit specific group's CLAUDE.md

Adding New Commands

Questions to ask:

• What should the command do?
• Available in all groups or main only?
• Does it need new MCP tools?

Implementation:

1. Add command handling in processMessage() in src/index.ts
2. Check for the command before normal routing logic

Changing Deployment

Questions to ask:

• Target platform? (Linux server, different Mac)
• Service manager? (systemd, launchd, supervisord)

Implementation:

1. Create appropriate service files
2. Update paths in config
3. Provide setup instructions

After Changes

Always tell the user:

# Rebuild and restart
bun run build
launchctl unload ~/Library/LaunchAgents/com.gandalf.plist
launchctl load ~/Library/LaunchAgents/com.gandalf.plist

Example Interaction

User: "Add Telegram as an input channel"

1. Ask: "Should Telegram messages go to existing groups or new ones?"
2. Ask: "Should Telegram messages create separate conversation contexts, or share with WhatsApp groups?"
3. Find Telegram MCP or library
4. Add connection handling in index.ts
5. Update message storage in db.ts
6. Tell user how to authenticate and test