> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alterhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome

> Documentation for Alter, the macOS AI assistant that lives in your notch

<Card title="Quick start" icon="rocket" href="/quickstart" horizontal>
  Learn the basics and start using Alter in minutes.
</Card>

## Start in 10 Minutes

<Steps>
  <Step title="Open Alter and grant permissions">
    Go to the [Quickstart guide](/quickstart) and complete the install and setup steps.
  </Step>

  <Step title="Learn core interaction modes">
    Open [Open Alter](/getting-started/open-alter) and try:

    * Hovering the notch
    * Opening with your shortcut
    * Speaking a simple request
  </Step>

  <Step title="Set up reliable context and tools">
    Apply context habits and automation basics from:

    * [Understand context and app awareness](/getting-started/understand-context-and-apps)
    * [Automate with workspaces and actions](/getting-started/automate-with-workspaces-and-actions)
  </Step>
</Steps>

## Quick Access

<Columns cols={2}>
  <Card title="Context and apps" icon="sparkles" href="/getting-started/understand-context-and-apps">
    Learn how Alter understands your app context and files.
  </Card>

  <Card title="Voice & Dictation" icon="microphone" href="/getting-started/capture-voice-and-meetings">
    Start dictation, transcription, and meeting follow-up workflows.
  </Card>

  <Card title="AI Models" icon="brain" href="/workflows/local-model-privacy">
    Pick local vs cloud model workflows based on privacy and speed.
  </Card>

  <Card title="Automation basics" icon="wand-magic-sparkles" href="/getting-started/automate-with-workspaces-and-actions">
    Build repeatable workflows with Workspaces and Actions.
  </Card>
</Columns>

## Popular Topics

<Columns cols={2}>
  <Card title="Quick Tasks" icon="bolt" href="/getting-started/open-alter">
    Step-by-step guides for common actions.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/common-issues/mic-not-transcribing">
    Solutions to common issues and problems.
  </Card>

  <Card title="Integrations" icon="plug" href="/apps-tools/integrations-overview">
    Connect Alter with your favorite tools.
  </Card>

  <Card title="FAQ" icon="circle-question" href="/references/faq-core">
    Answers to frequently asked questions.
  </Card>
</Columns>

## Need Help?

<CardGroup cols={3}>
  <Card title="Discord" icon="discord" href="https://discord.gg/gvCMmfBRWZ">
    Join our community
  </Card>

  <Card title="YouTube" icon="youtube" href="https://youtube.com/@useAlter">
    Watch tutorials
  </Card>

  <Card title="Email" icon="envelope" href="mailto:hi@alterhq.com">
    Contact support
  </Card>
</CardGroup>