docs: rewrite Agent UI guide — lead with features, not plumbing#641
Draft
kovtcharov wants to merge 7 commits intomainfrom
Draft
docs: rewrite Agent UI guide — lead with features, not plumbing#641kovtcharov wants to merge 7 commits intomainfrom
kovtcharov wants to merge 7 commits intomainfrom
Conversation
…shing setup-node with registry-url creates an .npmrc that sets NODE_AUTH_TOKEN, which overrides OIDC authentication. Removing it lets npm use the OIDC token from the id-token permission directly.
Prevents rc/alpha/beta tags from updating the release branch which publishes documentation.
…, examples - Add uninstall instructions (npm + Python CLI) with data cleanup - Add video demo placeholder for upcoming recording - Add MCP Client section explaining ~/.gaia/mcp_servers.json configuration - Add LLM timeout troubleshooting for misconfigured MCP servers - Expand "What You Can Do" with example prompts for each capability - Expand Session Management with actionable how-to details - Fix Windows compatibility in troubleshooting (Get-Content vs cat) - Soften Warning box to Note to reduce friction for new users Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Restructure to show what the agent can do before install instructions. Add hero intro, blockquote examples, format table, condensed MCP section. All technical content preserved.
- 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
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Rewrites the Agent UI guide to lead with the user experience instead of technical setup.
Structure changes:
Content additions:
Fixes:
--uiflag in port troubleshooting exampleGet-Contentvscat)Test plan
mintlify dev)/guides/mcp/client,/guides/mcp/agent-ui,/setup)assets.amd-gaia.ai