# Documentation


- **Getting Started**
- [Introduction](/docs): Learn what AgentOne is and how to get started.
- Installation
  - [Installation](/docs/installation): Download and install AgentOne on your operating system.
  - [Windows Setup Guide](/docs/installation/windows): Step-by-step instructions for installing AgentOne on Windows, including solutions for common installation issues
  - [macOS Setup Guide](/docs/installation/macos): Step-by-step instructions for installing AgentOne on macOS, including solutions for common installation issues
  - Linux
    - [Linux Setup Guide](/docs/installation/linux): Step-by-step instructions for installing AgentOne on Linux, with guides for each major distribution and package format
    - [AppImage](/docs/installation/linux/appimage): Step-by-step instructions for running AgentOne as an AppImage on any Linux distribution
    - [Arch Linux](/docs/installation/linux/arch-linux): Step-by-step instructions for installing AgentOne on Arch Linux using the AUR
    - [Debian & Ubuntu](/docs/installation/linux/debian-ubuntu): Step-by-step instructions for installing AgentOne on Debian and Ubuntu using a .deb package
    - [Fedora & RHEL](/docs/installation/linux/fedora-rhel): Step-by-step instructions for installing AgentOne on Fedora and RHEL using an .rpm package
    - [Snap Store](/docs/installation/linux/snap): Step-by-step instructions for installing AgentOne via the Snap Store on any Linux distribution
- Desktop App
  - [Desktop App](/docs/desktop-app): Learn how to use the AgentOne desktop app from onboarding through advanced features.
  - Getting Started
    - [Getting Started](/docs/desktop-app/getting-started): Install AgentOne, finish onboarding, and get to your first working chat.
    - [Onboarding](/docs/desktop-app/getting-started/onboarding): Walk through the first-run AgentOne onboarding flow step by step.
    - [Connect Your First Provider](/docs/desktop-app/getting-started/first-provider): Enable your first model provider so AgentOne can respond to chats.
    - [Your First Chat](/docs/desktop-app/getting-started/your-first-chat): Start a chat, pick a model, attach files, send your first message, and explore the composer.
    - [Desktop Layout](/docs/desktop-app/getting-started/desktop-layout): Learn where the main areas of the AgentOne desktop app are and what each one contains.
  - Chats
    - [Chats](/docs/desktop-app/chats): Learn how chats, the sidebar, search, attachments, editing, branching, and exports work.
    - [Chat Sidebar](/docs/desktop-app/chats/chat-sidebar): Use the sidebar to create, navigate, search, and manage your chats in AgentOne.
    - [Search Chats](/docs/desktop-app/chats/searching-chats): Search chat titles or message content from the sidebar or search dialog.
    - [Attachments](/docs/desktop-app/chats/attachments): Add files and attached chats to a conversation in AgentOne.
    - [Message Actions](/docs/desktop-app/chats/message-actions): Copy, edit, regenerate, and branch conversations from any message in AgentOne.
    - [Branch Conversations](/docs/desktop-app/chats/branching-conversations): Fork a conversation at any message to explore different directions without losing the original.
    - [Edit Messages](/docs/desktop-app/chats/editing-messages): Edit any message in a conversation and optionally regenerate from that point.
    - [Memory](/docs/desktop-app/chats/memory): Store persistent facts about yourself that the AI remembers across all your conversations.
    - [Exports and Deletion](/docs/desktop-app/chats/exports-and-deletion): Export single chats or multiple chats, and delete chats safely.
  - Settings
    - [Settings](/docs/desktop-app/settings): Learn what each settings section in AgentOne controls.
    - [Appearance](/docs/desktop-app/settings/appearance): Customize how AgentOne looks, including theme, colors, font, input style, and sidebar layout.
    - [Chat Settings](/docs/desktop-app/settings/chat-settings): Control markdown rendering, notifications, action rows, submit behavior, streaming, and chat titles.
    - [Keyboard Shortcuts](/docs/desktop-app/settings/keyboard-shortcuts): Customize keybindings for common actions in AgentOne.
    - [Performance](/docs/desktop-app/settings/performance): Tune rendering limits, virtualization, and extension loading to keep AgentOne fast.
    - [Help and Updates](/docs/desktop-app/settings/help-and-updates): Check for app updates, open help links, and manage analytics preferences.
  - Account & Sync
    - [Account and Sync](/docs/desktop-app/account-and-sync): Sign in, manage your plan, sync settings, and control account-related features.
    - [Sign In and Plan](/docs/desktop-app/account-and-sync/sign-in-and-plan): Sign in to AgentOne, view your plan details, and manage billing from the app.
    - [Sync Settings](/docs/desktop-app/account-and-sync/sync-settings): Enable settings sync to keep your AgentOne preferences consistent across devices.
    - [Profile and Instructions](/docs/desktop-app/account-and-sync/profile-and-instructions): Set your display name and add global AI instructions that apply to every conversation.
  - Shortcuts & Links
    - [Shortcuts and Links](/docs/desktop-app/shortcuts-and-links): Use keyboard shortcuts and supported deep links in AgentOne.
    - [Keyboard Shortcuts](/docs/desktop-app/shortcuts-and-links/keyboard-shortcuts): The built-in keyboard shortcuts in AgentOne and how to use them effectively.
    - [Deep Links](/docs/desktop-app/shortcuts-and-links/deep-links): Open AgentOne chats and extension installs from URLs using the agent-one:// scheme.
  - Troubleshooting
    - [Troubleshooting](/docs/desktop-app/troubleshooting): Fix common AgentOne desktop app problems.
    - [Providers and Models Troubleshooting](/docs/desktop-app/troubleshooting/providers-and-models): Resolve common provider, API key, and model availability issues.
    - [Extensions Troubleshooting](/docs/desktop-app/troubleshooting/extensions): Fix common issues with built-in tools, registry installs, and custom MCP servers.
    - [Notifications and Updates Troubleshooting](/docs/desktop-app/troubleshooting/notifications-and-updates): Fix completion notifications and desktop app update problems.

- **Guides**
- [Smithery Integration](/docs/guides/smithery-integration): Use Smithery extensions in the AgentOne desktop app.
- Custom Extensions
  - [Using Custom MCP Servers (Extensions) in AgentOne](/docs/guides/custom-extensions): Learn what MCP is and how to connect any MCP server to AgentOne
  - [Use Canva with AgentOne](/docs/guides/custom-extensions/canva-mcp): Connect AgentOne to your Canva account to design with AI
  - [Connect AgentOne to fast-filesystem-mcp](/docs/guides/custom-extensions/fast-filesystem-mcp): Detailed guide on how to connect AgentOne to the fast-filesystem-mcp MCP server
- Extensions
  - [Extensions](/docs/guides/extensions): Use built-in tools, install registry extensions, and add custom MCP servers in AgentOne.
  - [Approval and Authentication](/docs/guides/extensions/approval-and-auth): Control when AgentOne asks before running extension tools, and connect extensions that require authentication.
  - [Built-in Tools](/docs/guides/extensions/built-in-tools): Configure the built-in tools that ship with AgentOne and understand what each one does.
  - [Dangling Extensions](/docs/guides/extensions/dangling-extensions): Find and remove extension entries that no longer match known registry records.
  - [Extension Registry](/docs/guides/extensions/extension-registry): Browse, search, install, and manage extensions from the AgentOne extension registry.
  - [Install Extensions](/docs/guides/extensions/install-extension): Install registry extensions and review their detected configuration before enabling them.
- Providers
  - [Providers](/docs/guides/providers): Learn what a provider is and how to connect a provider to AgentOne
  - [Anthropic](/docs/guides/providers/anthropic): Connect Anthropic Claude models to AgentOne with your API key.
  - [Automatic Model Detection](/docs/guides/providers/automatic-model-detection): Learn what automatic model detection in AgentOne is and why it's useful
  - [Built-in Providers](/docs/guides/providers/built-in-providers): Enable built-in cloud providers, add API keys, and manage model overrides in AgentOne.
  - [Custom Providers](/docs/guides/providers/custom): Learn how to add custom OpenAI-compatible providers to AgentOne
  - [Google Gemini](/docs/guides/providers/google): Connect Google Gemini models to AgentOne with your API key.
  - [Groq](/docs/guides/providers/groq): Connect Groq's fast inference models to AgentOne with your API key.
  - [LM Studio](/docs/guides/providers/lm-studio): Use LM Studio as a local provider inside AgentOne to run models on your own hardware.
  - [Local Providers](/docs/guides/providers/local-providers): Use Ollama and LM Studio as built-in local providers inside AgentOne.
  - [Mistral](/docs/guides/providers/mistral): Connect Mistral AI models to AgentOne with your API key.
  - [Model Config](/docs/guides/providers/model-config): Adjust per-chat model parameters like temperature, max tokens, and sampling settings.
  - [Model Metadata](/docs/guides/providers/model-metadata): Understand the metadata fields AgentOne stores for each model and why they matter.
  - [Model Selector](/docs/guides/providers/model-selector): Choose and switch models from the chat composer in AgentOne.
  - [Local LLMs with Ollama](/docs/guides/providers/ollama-local-llms): Use AgentOne's built-in Ollama provider to run open-source models locally
  - [OpenAI](/docs/guides/providers/openai): Connect OpenAI models to AgentOne with your API key.