Settings

General

• Check for updates and install new desktop releases
• Choose the stable or beta update channel
• 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, GitHub Integration, Git Branches, and Diff Viewer.

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 and 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, Vim, Language servers and 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, Athas Agent, Inline AI, External Agents, Providers and Models, Database Viewer, SQLite, DuckDB, PostgreSQL, MySQL, MongoDB, Redis, and Integrations.

Account and Enterprise

• Sign in, view your current plan, open billing, and manage your Athas account
• Enterprise workspaces 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.

Find a setting

Use Settings search rather than scanning every section. A disabled setting can be controlled by enterprise policy. Keep a backup before resets and inspect Troubleshooting when a setting does not take effect.