# Settings

Source: https://athas.dev/docs/settings

Customize Athas across appearance, editor, Git, terminal, AI, account, and advanced controls.

## General

- [Check for updates](https://athas.dev/docs/updates) and install new desktop releases
- Choose the stable or [beta update channel](https://athas.dev/docs/updates#beta-updates)
- Install, copy, or uninstall the `athas` terminal command
- Import matching setup from another editor
- Choose where to report a bug with environment details

## Import Settings from Other Editors

Use **Settings > General > Import Settings** to import compatible setup from
another editor through a command-palette style picker.

Athas currently imports recent local projects from VS Code-family editors,
Cursor, Windsurf, Zed, and JetBrains IDEs. The flow is designed to grow into
matching settings, keybindings, integrations, and other compatible setup data as
those mappings become available.

## Appearance

- Switch color themes and upload custom theme JSON files
- Pick an icon theme and separate UI font family and size
- Sync light and dark themes with the OS
- Change sidebar position, sidebar tab layout, title bar project mode, and GitHub sidebar section visibility
- Choose whether opening another project uses a new window

## Features

- Turn major product surfaces on or off, including GitHub, Remote, Terminal, Search, Diagnostics, AI, Breadcrumbs, and Persistent Commands

## Editor and Files

- Tune editor font, size, tab size, wrapping, line numbers, minimap, and max open tabs
- Enable relative line numbers for Vim mode
- Turn on Auto Save
- Route files to an external terminal editor such as Neovim, Helix, Vim, or a custom command
- Hide files and directories in Files with comma-separated glob patterns

## Git

- Enable or disable Git integration
- Control Git panel behavior with auto refresh, discard confirmation, folder-based changes, staged ordering, and empty-section collapsing
- Choose the default diff layout and whether clicking a changed file opens the diff directly
- Show Git status decorations in Files, inline blame in the editor, and Git gutter markers

See [Git Integration](https://athas.dev/docs/git-integration), [GitHub Integration](https://athas.dev/docs/github-integration),
[Git Branches](https://athas.dev/docs/git-branches), and [Diff Viewer](https://athas.dev/docs/git-diff).

## Terminal

- Choose a default shell and default profile for new tabs
- Create custom terminal profiles with shell overrides, startup directories, and startup commands
- Turn shell integration (command marks, exit codes, directory tracking) and command notifications on or off
- Tune terminal font, scrollback, minimum contrast, cursor style, blinking, and cursor width

See [Terminal](https://athas.dev/docs/terminal) and [CLI](https://athas.dev/docs/cli).

## Language and Keyboard

- Set the default language or keep auto-detection enabled
- Enable format on save, lint on save, auto completion, and parameter hints
- Switch keybinding presets, enable Vim mode, and edit shortcuts in the keybindings editor
- Import or export custom keybindings

See [Keymaps](https://athas.dev/docs/keymaps), [Vim](https://athas.dev/docs/vim), [Language servers](https://athas.dev/docs/language-servers)
and [Formatting](https://athas.dev/docs/formatting).

## AI, Integrations, and Databases

- Choose a default model and overrides for new chats, inline edits and other features
- Configure personal provider keys, Ollama and custom endpoints in **AI > Models & keys**
- Configure Ollama for local or cloud use, including endpoint and API key
- Configure **AI > Tab completion** independently from inline edits
- Set agent user rules, behavior and permissions, and connect MCP servers
- Clear local chat history
- Install, update, remove, and search integrations across languages, themes, icons, databases, and custom UI integrations
- Manage saved network database connections and open SQLite or DuckDB files with the built-in viewer

See [AI](https://athas.dev/docs/ai), [Athas Agent](https://athas.dev/docs/athas-agent), [Inline AI](https://athas.dev/docs/inline-ai), [External Agents](https://athas.dev/docs/external-agents), [Providers and Models](https://athas.dev/docs/ai-providers), [Database Viewer](https://athas.dev/docs/database-viewer), [SQLite](https://athas.dev/docs/sqlite), [DuckDB](https://athas.dev/docs/duckdb), [PostgreSQL](https://athas.dev/docs/postgresql), [MySQL](https://athas.dev/docs/mysql), [MongoDB](https://athas.dev/docs/mongodb), [Redis](https://athas.dev/docs/redis), and [Integrations](https://athas.dev/docs/integrations).

## Account and Enterprise

- Sign in, view your current plan, open billing, and manage your Athas account
- [Enterprise workspaces](https://athas.dev/docs/enterprise) can enforce managed mode, integration allowlists, BYOK policy, and AI feature access

## Advanced

- Turn anonymous usage telemetry on or off
- Inspect the local telemetry log
- Reset all settings back to defaults

See [Telemetry](https://athas.dev/docs/telemetry).

## Find a setting

Use Settings search rather than scanning every section. A disabled setting can be controlled by [enterprise policy](https://athas.dev/docs/enterprise). Keep a backup before resets and inspect [Troubleshooting](https://athas.dev/docs/troubleshooting) when a setting does not take effect.