Search

Search docs and pages

Pages

Settings

General

  • Check for updates and install new desktop releases
  • 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, extensions, 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
  • Tune terminal font, scrollback, 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.

AI, Extensions, and Databases

  • Choose the Athas Agent provider and model
  • Use a custom OpenAI-compatible endpoint for Athas Agent with a base URL, model ID, and optional API key
  • Configure Ollama for local or cloud use, including endpoint and API key
  • Enable AI autocomplete, choose OpenRouter or Custom as its provider, and configure its model or endpoint
  • Clear local chat history
  • Install, update, remove, and search extensions across languages, themes, icon themes, databases, and custom UI extensions
  • 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 Extensions.

Account and Enterprise

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