You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: move hardware note to bottom, condense sessions and MCP sections
- Hardware disclaimer no longer kills momentum after the hero intro
- Sessions + keyboard shortcuts merged into one compact section
- MCP section reduced to card links — power users click through
Copy file name to clipboardExpand all lines: docs/guides/agent-ui.mdx
+28-38Lines changed: 28 additions & 38 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,10 +20,6 @@ gaia-ui
20
20
21
21
Everything installs automatically — Python, the AI model, the backend. No accounts, no API keys, no cloud. Just your machine.
22
22
23
-
<Note>
24
-
**Tested on AMD Ryzen AI MAX+ 395** with the **Qwen3.5-35B-A3B-GGUF** model via Lemonade Server. Other hardware or model combinations may work but are not officially verified. If you encounter issues, please [open a GitHub issue](https://github.com/amd/gaia/issues/new) with your processor model, RAM, LLM model, and OS.
25
-
</Note>
26
-
27
23
---
28
24
29
25
## What You Can Do
@@ -57,38 +53,6 @@ Drag files into the chat — or just ask the agent to find them. It indexes the
57
53
>
58
54
> *"What's the total spend in this expense report?"*
59
55
60
-
### Keep Conversations Organized
61
-
62
-
Sessions let you separate work by topic — one for your tax documents, another for a code review, a third for research. You can:
63
-
64
-
-**Create** a new session from the sidebar
65
-
-**Rename** sessions by clicking the title
66
-
-**Search** across all sessions with `Ctrl+K`
67
-
-**Export** as Markdown or JSON
68
-
-**Delete** with confirmation
69
-
70
-
Sessions sync between the CLI (`gaia chat`) and the Agent UI — start in one, pick up in the other.
71
-
72
-
### Extend with External Tools (MCP)
73
-
74
-
Connect external MCP servers to give the agent access to GitHub, Slack, databases, and more:
75
-
76
-
```bash
77
-
gaia mcp add time"uvx mcp-server-time"
78
-
```
79
-
80
-
Or expose the Agent UI itself as an MCP server — letting Claude Code, Cursor, or any MCP client drive GAIA agents programmatically. Conversations appear in the UI in real time.
81
-
82
-
<CardGroupcols={2}>
83
-
<Cardtitle="Use as MCP Server"icon="server"href="/guides/mcp/agent-ui">
84
-
Let external AI tools control GAIA agents through 15 built-in tools
Connect external services to extend the agent's capabilities
89
-
</Card>
90
-
</CardGroup>
91
-
92
56
---
93
57
94
58
## Install
@@ -195,14 +159,36 @@ Or expose the Agent UI itself as an MCP server — letting Claude Code, Cursor,
195
159
196
160
---
197
161
198
-
## Keyboard Shortcuts
162
+
## Sessions and Shortcuts
163
+
164
+
Sessions let you organize conversations by topic. They sync between the CLI (`gaia chat`) and the Agent UI — start in one, pick up in the other. Export any session as Markdown or JSON from the session menu.
199
165
200
166
| Shortcut | Action |
201
167
|----------|--------|
202
168
|`Enter`| Send message |
203
169
|`Shift+Enter`| New line |
204
170
|`Escape`| Stop agent response |
205
-
|`Ctrl+K`| Focus sidebar search |
171
+
|`Ctrl+K`| Search across sessions |
172
+
173
+
---
174
+
175
+
## Extend with MCP
176
+
177
+
The agent supports the **Model Context Protocol** in both directions — connect external tools to expand what the agent can do, or expose the Agent UI itself so other AI tools can drive it.
178
+
179
+
<CardGroupcols={2}>
180
+
<Cardtitle="Add Tools to the Agent"icon="plug"href="/guides/mcp/client">
181
+
Connect GitHub, Slack, databases, and more via MCP servers
182
+
</Card>
183
+
184
+
<Cardtitle="Expose Agent UI to Other Tools"icon="server"href="/guides/mcp/agent-ui">
185
+
Let Claude Code, Cursor, or any MCP client control GAIA agents
186
+
</Card>
187
+
</CardGroup>
188
+
189
+
<Warning>
190
+
Misconfigured MCP servers can cause slow responses. If you experience timeouts, check `~/.gaia/mcp_servers.json` and remove any servers you don't need. See [Troubleshooting](#llm-response-times-out-or-fails) for details.
191
+
</Warning>
206
192
207
193
---
208
194
@@ -325,6 +311,10 @@ For the REST API reference and backend classes, see the [Agent UI SDK Reference]
325
311
326
312
---
327
313
314
+
<Note>
315
+
**Hardware:** Tested on AMD Ryzen AI MAX+ 395 with Qwen3.5-35B-A3B-GGUF via Lemonade Server. Other configurations may work — [report issues here](https://github.com/amd/gaia/issues/new).
0 commit comments