> ## Documentation Index
> Fetch the complete documentation index at: https://ade-ac1c6011-ade-mobile-chat-stability-54bd7ef0.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings

> The main ADE settings sections and when to use them.

Open Settings with `Cmd+,` or the gear icon.

## Main sections

<CardGroup cols={2}>
  <Card title="General" icon="sliders">
    App updates, startup behavior, onboarding, help, and basic preferences.
  </Card>

  <Card title="Appearance" icon="palette">
    Theme, density, terminal appearance, and UI preferences.
  </Card>

  <Card title="AI Providers" icon="brain">
    Provider keys, CLI detection, default models, and session preferences.
  </Card>

  <Card title="Integrations" icon="plug">
    GitHub, Linear, proof, and external service connections.
  </Card>

  <Card title="Mobile" icon="mobile-screen">
    Pair the iOS app, manage devices, and choose notification behavior.
  </Card>

  <Card title="Usage" icon="chart-line">
    Review provider usage, budget signals, and session spend.
  </Card>
</CardGroup>

## Recommended first pass

<Steps>
  <Step title="Verify one provider">
    Make sure at least one agent provider is green.
  </Step>

  <Step title="Connect GitHub">
    Do this if you want PR creation, CI state, comments, and merge workflows.
  </Step>

  <Step title="Connect Linear">
    Do this if issues should link to lanes, CTO work, and PR updates.
  </Step>

  <Step title="Pair mobile">
    Do this if you want iPhone updates for agent work and PR activity.
  </Step>

  <Step title="Check usage">
    Set budgets or choose cheaper default models before running many agents in parallel.
  </Step>
</Steps>

## Provider settings

Provider settings control which agents can run. Keep at least one reliable default model configured, then override per chat or worker when needed.

## Local-first behavior

Settings that include secrets are stored locally. ADE does not commit credentials to your repository.

<CardGroup cols={2}>
  <Card title="AI providers" icon="brain" href="/configuration/ai-providers">
    Provider-specific setup and permission presets.
  </Card>

  <Card title="iOS companion" icon="mobile-screen" href="/tools/ios-companion">
    Pair your phone and manage mobile notifications.
  </Card>
</CardGroup>