> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heygaia.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Using GAIA on Discord
> Chat with GAIA, manage todos, and run workflows without leaving Discord
export const PlatformDemo = ({platform}) => {
const ui = useMemo(() => {
const cn = (...args) => args.filter(Boolean).join(" ");
const SF_STACK = '-apple-system, BlinkMacSystemFont, "SF Pro Display", "SF Pro Text", "Helvetica Neue", Helvetica, Arial, sans-serif';
const SLACK_STACK = '"Slack-Lato", "Lato", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif';
const DISCORD_STACK = '"gg sans", "Noto Sans", "Helvetica Neue", Helvetica, Arial, sans-serif';
const DEFAULT_AVATAR = "/images/demos/gaia-avatar.webp";
const AVATAR_ARYAN = "/images/demos/aryan-avatar.webp";
const PLATFORMS = {
whatsapp: {
phone: {
screenBackground: "#F6F6F6"
},
demo: {
title: "GAIA",
messages: [{
from: "me",
text: "what's on my plate today?",
time: "9:14",
status: "read"
}, {
from: "them",
text: "4 meetings back to back from 9.30, plus that investor draft you flagged yesterday",
time: "9:14"
}, {
from: "them",
text: "want me to push standup to 11 so you have a coffee window?",
time: "9:14"
}, {
from: "me",
text: "yes pls. also remind me to call mom at 8 π",
time: "9:15",
status: "read"
}, {
from: "them",
text: "done & done π«‘",
time: "9:15"
}]
}
},
telegram: {
phone: {
screenBackground: "#F6F6F6"
},
demo: {
title: "GAIA",
subtitle: "bot",
messages: [{
from: "me",
text: "summarise my inbox",
time: "14:02",
status: "read"
}, {
from: "them",
text: "you've got 12 unread. 3 actually need you, the rest is noise",
time: "14:03"
}, {
from: "them",
text: "drafting replies to the linear founder + the recruiter rn",
time: "14:03"
}, {
from: "me",
text: "also book me to NYC next thursday",
time: "14:04",
status: "read"
}, {
from: "them",
text: "looking⦠delta has $189 out at 8am, lands 11ish. lock it in?",
time: "14:04"
}]
}
},
slack: {
phone: {},
demo: {
title: "design",
subtitle: "42 members",
messages: [{
author: "Aryan",
avatar: AVATAR_ARYAN,
text: "@GAIA standup post for design? pull from yesterday's threads",
time: "10:24 AM"
}, {
author: "GAIA",
text: "pulled this from 4 open PRs and 6 figma comments since yesterday π§΅",
time: "10:24 AM",
reactions: [{
emoji: "π",
count: 4
}, {
emoji: "π₯",
count: 2
}]
}, {
author: "Aryan",
avatar: AVATAR_ARYAN,
text: "send it. also draft a reply to the PM thread in #product",
time: "10:25 AM"
}, {
author: "GAIA",
text: "on it. DMing you the draft in 30s",
time: "10:26 AM"
}]
}
},
discord: {
phone: {
screenBackground: "#1E1F22",
statusBarTone: "light"
},
demo: {
title: "general",
messages: [{
author: "Aryan",
avatar: AVATAR_ARYAN,
authorColor: "#F47FFF",
text: "@GAIA ship digest for the week?",
time: "9:14 PM",
reactions: [{
emoji: "π",
count: 3
}]
}, {
author: "GAIA",
authorColor: "#9CC3FF",
text: "12 PRs merged, 4 features shipped, 2 incidents resolved π",
time: "9:14 PM"
}, {
author: "Aryan",
avatar: AVATAR_ARYAN,
authorColor: "#F47FFF",
text: "post it in #releases",
time: "9:15 PM"
}, {
author: "GAIA",
authorColor: "#9CC3FF",
text: "posted, ping me if anyone has follow-ups",
time: "9:15 PM"
}]
}
}
};
const isDarkColor = color => {
if (!color) return false;
const c = color.trim().toLowerCase();
if (c === "#000" || c === "#000000" || c === "black") return true;
const hex = c.match(/^#([0-9a-f]{3}|[0-9a-f]{6})$/);
if (hex) {
let h = hex[1];
if (h.length === 3) h = h.split("").map(ch => ch + ch).join("");
const r = Number.parseInt(h.slice(0, 2), 16);
const g = Number.parseInt(h.slice(2, 4), 16);
const b = Number.parseInt(h.slice(4, 6), 16);
return (r * 299 + g * 587 + b * 114) / 1000 < 128;
}
const rgb = c.match(/rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)/);
if (rgb) {
const r = Number.parseInt(rgb[1], 10);
const g = Number.parseInt(rgb[2], 10);
const b = Number.parseInt(rgb[3], 10);
return (r * 299 + g * 587 + b * 114) / 1000 < 128;
}
return false;
};
const SideButtons = () => <>
;
const WifiIcon = ({color}) =>
;
const BatteryIcon = ({color, percent = 80}) => {
const clamped = Math.max(0, Math.min(100, percent));
return
;
};
const IPhoneMockup = ({time = "9:41", screenBackground, statusBarTone = "auto", hideStatusBar = false, homeIndicator = true, homeIndicatorTone = "auto", className, screenClassName, children}) => {
const resolvedTone = statusBarTone === "auto" ? isDarkColor(screenBackground) ? "light" : "dark" : statusBarTone;
const resolvedHomeTone = homeIndicatorTone === "auto" ? isDarkColor(screenBackground) ? "light" : "dark" : homeIndicatorTone;
const fg = resolvedTone === "light" ? "#ffffff" : "#000000";
return
{!hideStatusBar &&
}
{children}
{homeIndicator &&
}
;
};
const TAIL_THEM = "M 20 0 L 20 2 A 16 16 0 0 1 4 18 L 0 18 L 0 17.54 A 10 10 0 0 0 7 8 L 7 0 Z";
const TAIL_ME = "M 0 0 L 0 2 A 16 16 0 0 0 16 18 L 20 18 L 20 17.54 A 10 10 0 0 1 13 8 L 13 0 Z";
const CurvedBubble = ({from, tail, background, tailColor, color, children, meta, maxWidthPct = 78, className}) => {
const isMe = from === "me";
return
{children}
{meta &&
{meta}
}
{tail &&
}
;
};
const curvedThread = messages => {
const out = [];
for (const m of messages) {
const from = m.from ?? "them";
const last = out[out.length - 1];
if (last && last.from === from) last.items.push(m); else out.push({
from,
items: [m]
});
}
return out;
};
const groupByAuthor = messages => {
const out = [];
for (const m of messages) {
const last = out[out.length - 1];
if (last && last.author?.name === m.author) {
last.items.push(m);
} else {
out.push({
author: {
name: m.author ?? "Unknown",
avatar: m.avatar,
color: m.authorColor
},
items: [m]
});
}
}
return out;
};
const TypingDots = ({color}) =>
{[0, 1, 2].map(i => ;
const MicIcon = ({size = 22}) =>
;
const AttachmentIcon = ({size = 22}) =>
;
const CameraIcon = ({size = 22}) =>
;
const EmojiIcon = ({size = 22}) =>
;
const CurvedMessageThread = ({grouped, myBubble, theirBubble, textColor, metaColor, myMeta, TicksComponent}) => <>
{grouped.map((group, gi) => {
const isMe = group.from === "me";
return
{group.items.map((m, i) => {
const isLast = i === group.items.length - 1;
const showMeta = !m.typing && (m.time || isMe && m.status);
const resolvedMetaColor = isMe && myMeta ? myMeta : metaColor;
return
{m.time ?? ""}
{isMe && m.status && TicksComponent && ;
})}
;
})}
;
const ChatComposer = ({chromeBg, iconColor, borderColor, LeftIcon, leftLabel, buttonSize}) => ;
const ReactionsBar = ({items, spanStyle}) => {
const reactions = items.flatMap(m => (m.reactions ?? []).map((r, ri) =>
{r.emoji}
{r.count}
));
if (!reactions.length) return null;
return {reactions}
;
};
const IOSChatHeader = ({accent, chromeBg, backLabel, center, right}) =>
{backLabel &&
{backLabel} }
{center}
{right}
;
const WhatsAppTicks = ({status}) => {
const color = status === "read" ? "#3497F9" : "rgba(0,0,0,0.4)";
if (status === "sent") {
return
;
}
return
;
};
const WhatsAppDemo = ({messages, title, headerAvatar, showComposer, showHeader, className}) => {
const bg = "#EFEFF4";
const chromeBg = "#F6F6F6";
const myBubble = "#DCF7C5";
const theirBubble = "#FFFFFF";
const textColor = "#060606";
const metaColor = "rgba(0,0,0,0.45)";
const accent = "#007AFF";
const grouped = curvedThread(messages);
return
{showHeader &&
{title ?? "GAIA"}
} right={
} />}
{showComposer &&
;
}
return
;
};
const TelegramDemo = ({messages, title, subtitle, headerAvatar, showComposer, showHeader, className}) => {
const chromeBg = "#F6F6F6";
const blueOverlay = "#2B78CD";
const myBubble = "#E1FEC6";
const theirBubble = "#FFFFFF";
const textColor = "#060606";
const metaColor = "#858E99";
const myMeta = "#3EAA3C";
const accent = "#037EE5";
const grouped = curvedThread(messages);
return
{showHeader &&
{title ?? "GAIA"}
{subtitle ?? "last seen recently"}
} right={} />}
{showComposer &&
{p}
;
}
if ((/^#\w+/).test(p)) {
return {p} ;
}
if ((/^`[^`]+`$/).test(p)) {
return
{p.slice(1, -1)}
;
}
return {p} ;
});
};
const SlackDemo = ({messages, title, subtitle, showHeader, theme, className}) => {
const isDark = theme === "dark";
const bg = isDark ? "#1A1D21" : "#FFFFFF";
const fg = isDark ? "#D1D2D3" : "#1D1C1D";
const muted = isDark ? "#ABABAD" : "#616061";
const headerBorder = isDark ? "#2F3236" : "#E8E8E8";
const groups = groupByAuthor(messages);
return
{showHeader &&
{subtitle ?? "Add a topic"}
}
{groups.map((g, gi) =>
{g.author?.name ?? "Unknown"}
{g.items[0].time ?? ""}
{g.items.map((m, i) =>
{m.typing ?
)}
{g.items.some(m => m.reactions?.length) &&
({
padding: "1px 7px",
borderRadius: 12,
border: `1px solid ${isDark ? "#3a3d42" : "#DDDDDD"}`,
background: isDark ? "#26282C" : "#F1F4F7",
fontSize: 12,
fontWeight: 700,
color: isDark ? "#9DB0CA" : "#1264A3"
})} />}
)}
{p} ;
}
if ((/^#\w+/).test(p)) {
return {p} ;
}
if ((/^`[^`]+`$/).test(p)) {
return {p.slice(1, -1)};
}
return {p} ;
});
};
const DiscordCircleButton = ({bg, fg, label, children}) =>
{children}
;
const DiscordDemo = ({messages, title, showComposer, showHeader, className}) => {
const bg = "#1E1F22";
const fg = "#DBDEE1";
const muted = "#949BA4";
const iconBg = "#2B2D31";
const groups = groupByAuthor(messages);
return
{showHeader &&
}
{groups.map((g, gi) =>
{g.author?.name ?? "Unknown"}
Today at {g.items[0].time ?? ""}
{g.items.map((m, i) =>
{m.typing ?
)}
{g.items.some(m => m.reactions?.length) &&
({
padding: "2px 7px",
borderRadius: 8,
border: "1px solid rgba(88,101,242,0.3)",
background: "rgba(88,101,242,0.15)",
fontSize: 13,
fontWeight: 600,
color: "#A8B6FF"
})} />}
)}
{showComposer &&
}
{messages.map((msg, idx) => {
const from = msg.from === "user" ? "me" : "them";
const next = messages[idx + 1];
const prev = messages[idx - 1];
const lastOfGroup = !next || next.from !== msg.from;
const newGroup = prev && prev.from !== msg.from;
const classes = ["docs-imsg-bubble", `docs-imsg-from-${from}`, lastOfGroup ? "" : "docs-imsg-no-tail", newGroup ? "docs-imsg-group-gap" : ""].filter(Boolean).join(" ");
return
{msg.text}
;
})}
Add the bot to your server via [this link](https://heygaia.io/discord-bot), or join the [GAIA community server](https://discord.heygaia.io). You can also DM the bot directly.
Run `/auth`. You'll get a link, click it, sign in, and your account is connected.
```
/auth
```
Once linked, GAIA carries over your preferences, integrations, and conversation history everywhere.
Use `/gaia` followed by your message:
```
/gaia What's on my schedule today?
```
Or just type freely in a DM, no command prefix needed.
DMs are the most private way to use GAIA. In a DM, only you and the bot see
the conversation.
## What you can do
Ask GAIA anything. Responses stream in real time with a typing indicator so you know it's working.
` | Create a new todo |
| `/workflow list` | List all your workflows |
| `/workflow execute <id>` | Run a workflow manually |
| `/new` | Start a fresh conversation |
| `/help` | Show all available commands |
For the complete reference including subcommand options, see the [Bot Commands Reference](/bots/commands).
## Discord-only features
### @Mention in any channel
Mention the bot in a server channel and GAIA replies right there, no slash command needed.
<Chat
messages={[
{ from: "user", text: "@GAIA What time is the team standup tomorrow?" },
{ from: "gaia", text: "Standup is at 9:30 AM in #engineering." },
]}
/>
### Context menu actions
Right-click (or long-press on mobile) any message to get two quick actions:
* **Summarize with GAIA**: Get a 2-3 sentence summary of the selected message.
* **Add as Todo**: Turn any message into a todo item instantly.
<Tip>
These work on any message in the server, not just your own. Use them to pull
action items out of team discussions without breaking the conversation.
</Tip>
### Rich embeds and private replies
Responses use native Discord embeds with structured fields and action buttons, and slash command replies are visible only to you by default, other server members won't see what you asked.
### Workflow creation
Create new workflows directly from Discord:
```
/workflow create <name> <description>
```
## Tips
* **Connect your integrations first.** Link Gmail, Google Calendar, GitHub, and other tools from the [GAIA web app](/guides/connecting-integrations) so GAIA can act on your behalf.
* **Use DMs for personal tasks** and channels for team context, mention GAIA in a project channel so everyone sees the answer.
* **Start fresh when switching topics.** Run `/new` to clear conversation context before asking about something unrelated.
## Troubleshooting
| Problem | Solution |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Bot does not respond | Check that the bot is online with `/status`. Verify the bot has **Send Messages** and **Use Slash Commands** permissions in your channel. |
| Authentication link expired | Run `/auth` again to get a fresh link. |
| Commands missing from autocomplete | The server admin may need to re-deploy commands. |
| Long responses are cut off | Discord truncates messages at 2,000 characters. GAIA splits longer responses into multiple messages automatically. |
<Note>
Want to run your own instance of the Discord bot? See [Discord Bot Development](/bots/discord).
</Note>