# Alter Documentation ## Docs - [Welcome](https://docs.alterhq.com/index.md): Documentation for Alter, the macOS AI assistant with QuickHub, Edge Bar, and deep Hub workflows - [Quickstart](https://docs.alterhq.com/quickstart.md): Get started with Alter in three simple steps - [Guides](https://docs.alterhq.com/getting-started/guides-index.md): Choose a learning path to get the most out of Alter - [Getting Started](https://docs.alterhq.com/getting-started/getting-started-path.md): Learn the different ways to open and interact with Alter on your Mac - [Open Alter](https://docs.alterhq.com/getting-started/open-alter.md): Learn the fastest ways to open Alter and send your first prompt - [QuickHub Mode](https://docs.alterhq.com/getting-started/quickhub-mode.md): Alter's default conversation interface — floating QuickHub vs the legacy notch - [Edge Bar](https://docs.alterhq.com/getting-started/edge-bar.md): Reveal quick actions from your screen edge — meetings, QuickHub, chats, and Computer Use sessions - [Understand the Interface](https://docs.alterhq.com/getting-started/your-workspace.md): Get comfortable with the Alter window, context area, and chat flow - [Window Types: QuickHub, Hub, and Panels](https://docs.alterhq.com/getting-started/window-types-notch-hub-panels.md): Understand Alter's interface modes — QuickHub (default), the Hub, Edge Bar, and the legacy notch - [Split Panel](https://docs.alterhq.com/getting-started/split-panel.md): Work in two Hub conversation panes side by side and bridge context between them - [Run Your First Workflows](https://docs.alterhq.com/getting-started/first-workflows.md): Use practical workflows for writing, meetings, and everyday tasks - [Core features](https://docs.alterhq.com/getting-started/core-features.md): Overview of app context, files, workspaces, and actions with links to focused getting-started pages - [Understand context and app awareness](https://docs.alterhq.com/getting-started/understand-context-and-apps.md): Learn how Alter uses app context, follow mode, and files to give better answers - [Use current app and Follow Mode](https://docs.alterhq.com/getting-started/use-current-app-and-follow-mode.md): Keep app context synced so Alter can help without repeated explanations - [Add files, folders, and media](https://docs.alterhq.com/getting-started/add-files-and-media.md): Use drag and drop context for documents, images, audio, and code - [Capture voice and meetings](https://docs.alterhq.com/getting-started/capture-voice-and-meetings.md): Use dictation, transcription, and meeting workflows from day one - [Use workspaces for bigger tasks](https://docs.alterhq.com/getting-started/workspaces-basics.md): Index folders and files once so Alter can work across larger contexts - [Create reusable actions](https://docs.alterhq.com/getting-started/actions-basics.md): Turn repeated prompts into reliable workflows with model and tool control - [Automate with workspaces and actions](https://docs.alterhq.com/getting-started/automate-with-workspaces-and-actions.md): Get repeatable results by combining persistent context and reusable actions - [Check unread emails and draft replies with Alter](https://docs.alterhq.com/workflows/manage-mail-with-alter.md): What Alter can currently do with Apple Mail, with practical prompts and setup - [Send iMessages faster with Alter](https://docs.alterhq.com/workflows/send-messages-with-alter.md): What Alter can currently do with Messages, with practical prompts and setup - [Manage contacts with Alter](https://docs.alterhq.com/workflows/manage-contacts-with-alter.md): What Alter can currently do with Apple Contacts, with practical prompts and setup - [Manage your schedule with Alter](https://docs.alterhq.com/workflows/manage-calendar-with-alter.md): What Alter can do with Apple Calendar, when to use it, and prompts you can copy - [Plan places and routes with Alter Maps](https://docs.alterhq.com/workflows/plan-places-and-routes-with-alter-maps.md): What Alter can currently do with Apple Maps, with practical prompts and setup - [Meetings](https://docs.alterhq.com/workflows/meetings.md): Professional meeting transcription with speaker identification and offline processing - [Dictation](https://docs.alterhq.com/workflows/dictation.md): Voice commands, speech-to-text, and advanced dictation features - [Memory](https://docs.alterhq.com/workflows/memory.md): Let Alter remember useful facts across chats, workspaces, and meetings—then recall them when you need them - [Memory Catch-Up](https://docs.alterhq.com/workflows/memory-catch-up.md): The recommended way to seed Memory from your last 30 days of chats and meetings in one trusted review - [Capture and organize notes with Alter](https://docs.alterhq.com/workflows/manage-notes-with-alter.md): What Alter can do with Apple Notes, when to use it, and prompts you can copy - [Summarize your X feed with Computer Use](https://docs.alterhq.com/workflows/summarize-x-feed-with-computer-use.md): Use Alter Computer Use to read what is visible in your X timeline and generate structured summaries - [Keep Your Data Private with Local AI](https://docs.alterhq.com/workflows/local-model-privacy.md): How to run AI models on your own Mac for sensitive documents and confidential work - [Automate Blogging with Alter](https://docs.alterhq.com/workflows/automate-blogging-with-alter.md): Teach Alter your writing style so it can help you automate content creation - [Stay on top of tasks with Alter](https://docs.alterhq.com/workflows/manage-reminders-with-alter.md): What Alter can do with Apple Reminders, when to use it, and prompts you can copy - [Workspaces and Actions Guide](https://docs.alterhq.com/workflows/workspaces-actions.md): Build repeatable flows by combining workspaces and Alter Actions - [Use Flow for Tool Orchestration](https://docs.alterhq.com/workflows/use-flow-orchestration.md): Let Flow automatically select and orchestrate your tools to reduce context usage and improve performance - [Coding tools](https://docs.alterhq.com/workflows/coding-tools.md): Run local coding sessions from Alter through ChatGPT, Cursor, OpenCode, and Claude Code - [Share and Export Task Traces](https://docs.alterhq.com/workflows/share-task-traces.md): Export task conversations as markdown, share traces with the Alter team, and open subagent chats from the Tool Inspector - [Alter Actions](https://docs.alterhq.com/workflows/alter-actions.md): Create and configure custom AI workflows with voice triggers and automation - [URL Callbacks](https://docs.alterhq.com/workflows/url-callbacks.md): Integrate Alter with other apps using x-callback-url schemes - [Getting started](https://docs.alterhq.com/workflows/web-research-getting-started.md): Get started with web research connectors in Alter - [Router-native search](https://docs.alterhq.com/workflows/native-web-search-in-alter-routers.md): Use Fast, Best, Fair, and Light for recent web-backed answers without extra connectors - [Included search tools](https://docs.alterhq.com/workflows/web-search-local-tools.md): Use Alter's built-in web search tools with no extra provider account - [Connect Tavily](https://docs.alterhq.com/workflows/connect-tavily.md): Connect Tavily as a Remote MCP Server for web research and extraction - [Connect Firecrawl](https://docs.alterhq.com/workflows/connect-firecrawl.md): Use Firecrawl with Alter for structured multi-page scraping - [Connect LinkUp](https://docs.alterhq.com/workflows/connect-linkup.md): Set up LinkUp in Alter through Apps Gallery or Remote MCP - [Connect Exa](https://docs.alterhq.com/workflows/connect-exa.md): Use Exa in Alter for web search workflows - [Overview](https://docs.alterhq.com/apps-tools/integrations-overview.md): Understand local tools and external integrations in Alter - [Gateways](https://docs.alterhq.com/apps-tools/gateways.md): Talk to Alter from Discord and Telegram while Alter runs on your Mac - [Set up a Discord gateway](https://docs.alterhq.com/apps-tools/gateways-discord.md): Create a Discord bot and connect it to Alter Gateways - [Set up a Telegram gateway](https://docs.alterhq.com/apps-tools/gateways-telegram.md): Create a Telegram bot with BotFather and connect it to Alter Gateways - [Buzz gateway (internal)](https://docs.alterhq.com/apps-tools/gateways-buzz.md): Join a Buzz community with Alter using an invitation link — dev team only - [Troubleshooting](https://docs.alterhq.com/apps-tools/integrations-troubleshooting.md): Fix common integration and tool issues in Alter - [Mail](https://docs.alterhq.com/apps-tools/mail.md): What Alter can do with Apple Mail local tools - [Calendar](https://docs.alterhq.com/apps-tools/calendar.md): What Alter can do with Apple Calendar local tools - [Notes](https://docs.alterhq.com/apps-tools/notes.md): What Alter can do with Apple Notes local tools - [Reminders](https://docs.alterhq.com/apps-tools/reminders.md): What Alter can do with Apple Reminders local tools - [Messages](https://docs.alterhq.com/apps-tools/messages.md): What Alter can do with Apple Messages local tools - [Contacts](https://docs.alterhq.com/apps-tools/contacts.md): What Alter can do with Apple Contacts local tools - [Maps](https://docs.alterhq.com/apps-tools/maps.md): What Alter can do with Apple Maps local tools - [DEVONthink](https://docs.alterhq.com/apps-tools/devonthink.md): Set up Alter as your AI provider in DEVONthink - [Overview](https://docs.alterhq.com/apps-tools/computer-use.md): Goal-based Computer Use agent for macOS UI automation — describe a task, Alter drives the apps - [Background Computer Use](https://docs.alterhq.com/apps-tools/computer-use-background.md): Run Computer Use tasks in the background while you keep working, with live preview and Edge Bar session controls - [Agent tools reference](https://docs.alterhq.com/apps-tools/computer-use-agent-tools.md): LLM-only tools used inside the Computer Use subagent — read_screen_ax, perform_sequence, list_windows, and more - [Get Active App Context](https://docs.alterhq.com/apps-tools/computer-use-get-active-app-context.md): Capture active window content and OCR text for Computer Use workflows - [Perform](https://docs.alterhq.com/apps-tools/computer-use-perform.md): Run click, fill, type, and shortcut actions against UI elements - [Wait](https://docs.alterhq.com/apps-tools/computer-use-wait.md): Pause execution between Computer Use actions - [Scroll](https://docs.alterhq.com/apps-tools/computer-use-scroll.md): Scroll active app windows in Computer Use flows - [How-To: Change Quick Access Hotkey](https://docs.alterhq.com/how-to/change-hotkey.md): Customize your keyboard shortcut for opening Alter - [Choosing your language](https://docs.alterhq.com/how-to/choose-language.md): Set your preferred language for AI generation output - [Choose your generative model](https://docs.alterhq.com/how-to/choose-generative-model.md): Pick the right model for speed, quality, vision, and privacy in Alter - [How-To: Use Your Own API Key](https://docs.alterhq.com/how-to/use-byok.md): Connect your own API keys from OpenAI, Mistral, and other providers - [Reinstall or downgrade Alter safely](https://docs.alterhq.com/how-to/reinstall-or-downgrade-alter.md): Replace Alter with another version without removing your local chats, transcripts, and other app data. - [How-To: Add Context to a Prompt](https://docs.alterhq.com/how-to/add-context.md): Add files, apps, and other context to your prompts - [Configuring Alter Settings](https://docs.alterhq.com/how-to/settings-guide.md): Learn how to customize Alter to match your preferences and manage your account - [Manage Memory](https://docs.alterhq.com/how-to/manage-memory.md): Configure Memory, review saved facts, open sources, and forget entries you no longer want - [Manage tools](https://docs.alterhq.com/how-to/tool-manager-guide.md): Connect and manage integrations safely with clear troubleshooting steps - [Manage context window](https://docs.alterhq.com/how-to/managing-context-window.md): Optimize your AI interactions by understanding and managing context window usage - [Microphone Not Working](https://docs.alterhq.com/common-issues/mic-not-transcribing.md): Fix voice input and dictation issues when Alter doesn't transcribe your speech - [Keyboard Shortcut Not Working](https://docs.alterhq.com/common-issues/hotkey-not-working.md): Fix hotkey issues when ⌘⇧Space or your custom shortcut won't open Alter - [Tools Not Working](https://docs.alterhq.com/common-issues/tool-not-working.md): Fix integrations when Alter won't use your connected tools and apps - [Data missing after reinstall or cleanup](https://docs.alterhq.com/common-issues/data-missing-after-reinstall.md): Understand why chats and transcripts can disappear after uninstalling Alter and what recovery options you may still have. - [Custom Models Not Showing](https://docs.alterhq.com/common-issues/custom-provider-not-showing.md): Fix missing OpenAI, Mistral, or local models in the model selector - [API Gateway Won't List Models](https://docs.alterhq.com/common-issues/models-not-listed-in-api-gateway.md): Fix empty model lists when connecting external apps to Alter's API - [Core FAQ](https://docs.alterhq.com/references/faq-core.md): Quick answers to common questions about using Alter - [General FAQ](https://docs.alterhq.com/references/general-faq.md): Use this for high-level 'about Alter' questions from the main website FAQ - [Local data and privacy](https://docs.alterhq.com/references/local-data-and-privacy.md): Understand what Alter stores locally, what is not synced to the cloud, and how to protect your data before reinstalling. - [Pricing FAQ](https://docs.alterhq.com/references/pricing-faq.md): Information about Alter plans, billing, fair use, and device limits - [Shortcuts](https://docs.alterhq.com/references/shortcuts.md): Complete list of keyboard shortcuts for Alter - [Documentation Map](https://docs.alterhq.com/references/docs-map.md): Quick reference to all sections of the Alter documentation - [Image Library](https://docs.alterhq.com/references/image-library.md): Canonical image URLs and references for Alter documentation - [API Router Overview](https://docs.alterhq.com/references/api-router-overview.md): Overview of the Alter API Router service and OpenAI-compatible endpoint - [API Gateway & Router Service](https://docs.alterhq.com/api-router/api-gateway.md): Use Alter as an OpenAI-compatible API endpoint for model routing - [API Router for Development](https://docs.alterhq.com/api-router/development.md): Use Alter API Router from SDKs and custom code - [API Router Operations & Troubleshooting](https://docs.alterhq.com/api-router/operations.md): Model selection, limits, reliability, and common fixes for Alter API Router - [App Integrations with API Router](https://docs.alterhq.com/api-router/app-integrations.md): Connect third-party apps to Alter API Router - [Set Up TypingMind with Alter API](https://docs.alterhq.com/api-router/typingmind.md): Connect TypingMind to Alter API Router using OpenAI Chat Completions format - [Set Up Msty.ai with Alter API](https://docs.alterhq.com/api-router/msty.md): Connect Msty.ai to Alter API Router with endpoint and API key configuration - [API Model Reference](https://docs.alterhq.com/references/api-model-names.md): Complete list of AI models available through the Alter API Router - [List available models](https://docs.alterhq.com/api-reference/list-available-models.md) - [Create a completion](https://docs.alterhq.com/api-reference/create-a-completion.md) - [Create a chat completion](https://docs.alterhq.com/api-reference/create-a-chat-completion.md) ## OpenAPI Specs - [openapi](https://docs.alterhq.com/openapi.json) ## Optional - [Website](https://alterhq.com) - [Discord](https://discord.gg/gvCMmfBRWZ) - [YouTube](https://youtube.com/@useAlter)