Docs › Using the editor › Layout, themes and the settings page

Layout, themes and the settings page

Where the chat sits, tabs or a side column, the theme, the activity bar, and a tour of every page in AstraCode Settings.

On this page

AstraCode keeps the editor's own layout and adds a few choices for where the chat goes and how the window looks. Most are in AstraCode Settings; this page covers those choices, then walks through every page of that settings screen.

Where the chat goes

A tab, or a side column

The chat can open as a tab in the editor area, beside your files, or in the side column opposite the Explorer. Open Chat as Editor Tabs (astracode.chatAsEditorTabs, on by default) decides which one AstraCode: Open Chat (Cmd+Shift+I, or Ctrl+Shift+I on Windows and Linux) uses. The side column is always there either way: AstraCode: Toggle Chat (Option+Cmd+J, or Ctrl+Alt+J) shows and hides it.

Which side

Chat side (astracode.layout.chatSide): Right (default) puts the chat column on the right and the Explorer on the left; Left swaps them. The layout buttons in the title bar do the same by hand.

Window Layout

Window Layout (astracode.windowLayout) arranges the window once, when you choose it. Agent opens the chat the way Open Chat does; Editor (default) shows it in the side column. Move things afterwards and they stay where you put them.

Hiding the editor when it is empty

Turn on Auto-Hide Editor When Empty (astracode.layout.autoHideEditorWhenEmpty, off by default) and closing your last file hides the editor area, so the chat fills the window. It only shows the area again if it hid it itself.

The home screen

Home in the editor (astracode.home) chooses what an empty editor area shows. Always (default): with a folder open, the AstraCode mark, sign-in and shortcuts; in an empty window, also Open, Clone, SSH and recent projects. Only in an empty window: the home appears only when no folder is open.

Theme

Choose Dark, Light or Match System with the cards under General, Theme in AstraCode Settings, or run AstraCode: Choose Theme and use the arrow keys to see each one as you move (Escape puts the old one back). Match System follows your operating system's appearance, including when it changes at sunset.

These set the editor's own colour theme, so Preferences: Color Theme and any theme from Open VSX work as well.

The activity bar

The settings page

Run AstraCode: Open Settings, or choose Agent settings in the chat's ⋯ menu. It opens as a tab, AstraCode Settings, and reopens on the page you left it on.

The sidebar has these pages:

General

The editor's own settings

Opens the editor's own settings. Its rows, found by search, open All Settings, Workspace Settings, the AstraCode Settings filtered to astracode, and settings.json.

Usage

Your plan, how much of your allowance is left and when it resets, additional usage and its limit, and Upgrade. See Usage and limits.

Agents

Customize

Models

Without your own key, this page says AstraOne chooses the model for each step, with Use my own key on plans from Pro up. With your own Anthropic key it shows Pinned Model (a model, or None: AstraCode chooses) and In the picker, a switch per model for the composer's menu. See Models and AstraOne.

Git & PRs

Co-author agent commits (off), a note that the agent always asks before pushing or publishing, and Review agent changes (Open). See Git.

Browser & Network

Tab

Every Tab completion setting, and Acceptance Rate. See Tab completion.

Docs

Opens the documentation in your browser.

If something goes wrong

← Dictation Agent overview →

All documentation

Get started

Using the editor

Agent

Context

Workspaces

Connectors

Extending AstraCode

CLI

Account and usage

Troubleshooting

Reference