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

# Settings

> Configure Gobi through VS Code's streamlined settings interface

<img src="https://mintcdn.com/gourmand/rp15OrN3WARO_f_5/images/gobi-settings-card-layout.png?fit=max&auto=format&n=rp15OrN3WARO_f_5&q=85&s=5742fd762e27d8a5f1634294fa8c6904" alt="Gobi Settings Panel - Card-based Layout" width="996" height="1732" data-path="images/gobi-settings-card-layout.png" />

The new settings experience introduces a **card-based layout** that reduces visual clutter while maintaining powerful functionality. Every setting is more discoverable and easier to modify, whether you're on an ultrawide monitor or a small laptop screen.

## Quick Access

<CardGroup cols={3}>
  <Card title="Settings Icon" icon="gear">
    Click the gear in the Gobi sidebar
  </Card>

  <Card title="VS Code Settings" icon="sliders">
    File → Preferences → Settings → Extensions → Gobi
  </Card>

  <Card title="Config File" icon="code">
    Edit `config.yml` directly for advanced options
  </Card>
</CardGroup>

<Tip>
  Use the toolbar buttons for quick access to specific settings: - **Rules**
  (pencil icon) - Custom coding preferences - **Tools** (wrench icon) - Manage
  integrations - **Models** (cube icon) - Configure AI providers
</Tip>

## Core Settings

<Tabs>
  <Tab title="Interface">
    <AccordionGroup>
      <Accordion title="Display Options" icon="display">
        | Setting          | Description                   |
        | ---------------- | ----------------------------- |
        | Session Tabs     | Manage multiple chat sessions |
        | Code Wrapping    | Auto-wrap long code lines     |
        | Markdown Display | Show raw markdown vs rendered |
        | Chat Scrollbar   | Toggle scrollbar visibility   |
      </Accordion>

      <Accordion title="Behavior" icon="wand-magic-sparkles">
        | Setting           | Description                           |
        | ----------------- | ------------------------------------- |
        | Auto-accept Diffs | Apply code changes automatically      |
        | Tool Rejection    | Gobi after tool rejection             |
        | Auto-naming       | Generate session titles automatically |
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Autocomplete">
    Configure code completions:

    <img src="https://mintcdn.com/gourmand/cY6wRTl5s2wbpiM-/images/autocomplete-settings.png?fit=max&auto=format&n=cY6wRTl5s2wbpiM-&q=85&s=d9f286b508ebe705ce1411083fe470d8" alt="Gobi Autocomplete Settings" width="568" height="328" data-path="images/autocomplete-settings.png" />

    <Note>
      Autocomplete models need to be added to your config to enable selecting an autocomplete model. If none is available, you will be linked to the docs showing recommended models. See our [model recommendations](/customize/model-roles/autocomplete) for the best autocomplete models.
    </Note>

    <img src="https://mintcdn.com/gourmand/cY6wRTl5s2wbpiM-/images/autocomplete-model-selection.png?fit=max&auto=format&n=cY6wRTl5s2wbpiM-&q=85&s=f3151620947b1079d885ed2c4b090d06" alt="Autocomplete Model Selection" width="566" height="480" data-path="images/autocomplete-model-selection.png" />

    <Info>
      To better understand how to set up configs and models, see our [Understanding Configs guide](/guides/understanding-configs).
    </Info>
  </Tab>

  <Tab title="Indexing">
    Control how Gobi understands your codebase:

    <img src="https://mintcdn.com/gourmand/HGSXhgUNM88nD3iS/images/indexing-settings.png?fit=max&auto=format&n=HGSXhgUNM88nD3iS&q=85&s=bc045db12067612c2073415ecbe9426d" alt="Gobi Indexing Settings" width="990" height="640" data-path="images/indexing-settings.png" />

    <Steps>
      <Step title="Enable Indexing">
        Toggle codebase indexing in the settings panel
      </Step>

      <Step title="Monitor Progress">
        Watch real-time status in the UI
      </Step>

      <Step title="Verify Coverage">
        Check which files are indexed via the status indicator
      </Step>
    </Steps>

    <Note>
      Indexing enables Gobi to understand your entire codebase structure, significantly improving context awareness and suggestions.
    </Note>
  </Tab>

  <Tab title="Experimental">
    <Warning>
      These features are in beta and may change or have stability issues.
    </Warning>

    | Feature                          | Purpose                                                                                 |
    | -------------------------------- | --------------------------------------------------------------------------------------- |
    | Add Current File by Default      | The currently open file is added as context in every new conversation                   |
    | Enable experimental tools        | Enables access to experimental tools that are still in development                      |
    | Only use system message tools    | Gobi will not attempt to use native tool calling and will only use system message tools |
    | @Codebase: use tool calling only | @codebase context provider will only use tool calling for code retrieval                |
    | Stream after tool rejection      | Streaming will gobi after the tool call is rejected                                     |
  </Tab>
</Tabs>

## Model & Assistant Selection

<img src="https://mintcdn.com/gourmand/cY6wRTl5s2wbpiM-/images/assistant-selector-dropdown.png?fit=max&auto=format&n=cY6wRTl5s2wbpiM-&q=85&s=2026adc5fa296705a0c61d32163bf8a5" alt="New assistant dropdown with cleaner icons and improved organization display" width="860" height="1040" data-path="images/assistant-selector-dropdown.png" />

The refined assistant selector features:

* **Organization badges** for easy provider identification
* **Smart error handling** that sorts problematic configurations while keeping them selectable
* **Keyboard navigation** for quick model switching

## Privacy & Data

<CardGroup cols={3}>
  <Card title="Local Processing" icon="lock">
    All code analysis happens locally unless explicitly shared
  </Card>

  <Card title="Telemetry Control" icon="chart-line">
    Opt in/out of anonymous usage statistics
  </Card>

  <Card title="Session Management" icon="database">
    Sessions auto-save and restore between IDE restarts
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Model Connection Issues" icon="plug">
    * Verify API keys in `config.yml` - Check network connectivity - Confirm
      endpoint URLs are correct
  </Accordion>

  <Accordion title="Tool Loading Failures" icon="wrench">
    * Review MCP server configurations - Check tool permissions - Verify tool
      dependencies are installed
  </Accordion>

  <Accordion title="Indexing Problems" icon="magnifying-glass">
    * Check file permissions
    * Review `.gitignore` patterns
    * Verify sufficient disk space
  </Accordion>
</AccordionGroup>

<Info>
  Still having issues? Check our comprehensive [troubleshooting
  guide](/troubleshooting) or visit the [FAQs](/faqs) for more solutions.
</Info>

## Next Steps

<CardGroup cols={2}>
  <Card title="Configure Models" icon="robot" href="/customization/models">
    Set up your AI providers
  </Card>

  <Card title="Add Tools" icon="wrench" href="/customization/mcp-tools">
    Extend Gobi with MCP tools
  </Card>

  <Card title="Custom Rules" icon="pencil" href="/customization/rules">
    Define coding preferences
  </Card>

  <Card title="Prompts" icon="message" href="/customization/prompts">
    Customize AI behavior
  </Card>
</CardGroup>