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
- Where the chat goes
- A tab, or a side column
- Which side
- Window Layout
- Hiding the editor when it is empty
- The home screen
- Theme
- The activity bar
- The settings page
- General
- The editor's own settings
- Usage
- Agents
- Customize
- Models
- Git & PRs
- Browser & Network
- Tab
- Docs
- If something goes wrong
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
- Where the activity icons sit (
workbench.activityBar.location): Down the left edge (default), Along the top of the sidebar, Along the bottom of the sidebar, or Hidden. - Activity icons on the bar (
astracode.activityBar.maxVisible): with the icons along the top or bottom, how many show before the rest move under the chevron: 3, 4 (default), 5, 6, or As many as fit. Down the left edge every icon fits, so this has no effect there. Nothing is ever hidden: the chevron lists the rest by name. - Right-click the bar to hide a view, or drag an icon to reorder.
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 search box at the top (Cmd+F, or Ctrl+F) searches every row on every page.
- The top bar shows the account you are signed in with and your plan, or Sign in when you are not.
- Every row here is also a setting you can set in
settings.json; the full list is in the Settings reference.
The sidebar has these pages:
General
- Account panel: your account, your plan and how much of it is left, with Manage account (your dashboard on astracode.io), Check for Updates and Log out. Signed out, Sign in. On the Free plan, an Upgrade card.
- AstraCode Account: Open for account and billing on the site.
- Editor tiles: Editor Settings, Keyboard Shortcuts and Extensions.
- Preferences: Import Settings (from the editor you use today); Reset "Don't Ask Again" Dialogs (brings back warnings you hid); Chat side; Home in the editor; Where plans are saved (in the repository's
.astracode/plans, or your home folder's~/.astracode/plans); Where the activity icons sit; Activity icons on the bar; Command line, Install for theastracommand. - Layout: Theme, Window Layout, Conversation Density (Detailed or Compact tool cards in the chat), Review Control Location, Auto-Hide Editor When Empty, Open Chat as Editor Tabs.
- Notifications: System Notifications (a notification when a run finishes while the window is not focused) and Completion Sound (a chime when a run finishes).
- Privacy: Privacy Mode, shown as Always on. It is not a switch; see What AstraCode sends and keeps.
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
- Conversation: Text Size (Small, Default, Large, Extra Large); Apply project rules in Ask mode (on); Clarifying questions in plan mode (on); Messages sent while the agent is working (Queue, the default, or Interrupt); Code Block Word Wrap (off); Usage Summary (Auto, Always or Never).
- Context and Tools: Read pages (on) lets the agent fetch a web page as text; Drive the browser (off) lets it use the built-in browser.
- Applying Changes: Format on finish (off) runs each file's formatter on the files the agent changed, when the run ends.
- Approval: Before the agent changes a file or runs a command: Always ask me first, Ask only for changes, not reads (default) or Never ask. Below it, Remembered commands for this folder, each with Forget. See Approvals and permissions.
- Engine: Agent Engine (In-house by default; switching starts a fresh conversation) and Step Limit (50, 150 by default, 400 or 1000 steps), a backstop against a run that will not finish.
Customize
- Instructions: Always-on custom instructions (Edit), included in every chat, edit and run; Engineering principles (on); Project rules (on); Project rules file (Open, or create one). See Rules.
- A browser for everything that extends the agent, with a search box and chips for Skills, Rules, Commands, Agents, MCP servers, Hooks and Plugins. Each has + New for you or for this project. See Skills and commands, Connectors, Hooks, Plugins and Subagents and background tasks.
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
- Default Address: where the built-in browser opens first in a workspace (
http://localhost:3000by default). - Agent Browser Control (off): the same switch as Drive the browser. See Browser tools.
- Open Browser: the built-in browser beside your code.
- Gateway: where requests go (
astracode.gatewayUrl). Change it only if your organisation runs its own. - Your own API key: Manage, on plans from Pro up. See Bring your own key.
Tab
Every Tab completion setting, and Acceptance Rate. See Tab completion.
Docs
Opens the documentation in your browser.
If something goes wrong
- The settings tab is blank after a restart. Close it and run AstraCode: Open Settings again.
- Auto-Hide Editor When Empty never hides the editor. If the editor said this build lacks the Toggle Editor Area Visibility command, the setting stays off.
- The chat panel is blank. Run AstraCode: Repair the Chat Panel. See Chat panel problems.
All documentation
Get started
Using the editor
- Tab completion
- Edit and ask about a selection
- Reviewing the agent's changes
- Git: commit messages, branch review and conflicts
- Dictation
- Layout, themes and the settings page
Agent
- Agent overview
- Agent, Plan, Ask and Debug
- Approvals and permissions
- Plan mode
- Debug mode
- Tools
- Browser tools
- How the agent checks its work
- Checkpoints and undo
- Running several agents at once
- Subagents and background tasks
- Remote agents in GitHub Actions
- Infrastructure as code
Context
Workspaces
Connectors
- Connectors (MCP servers)
- Connector configuration reference
- Use AstraCode from Claude, ChatGPT and other apps
Extending AstraCode
CLI
Account and usage
- Usage and limits
- Bring your own key
- What AstraCode sends and keeps
- Reporting a problem and getting help
Troubleshooting
- Troubleshooting
- Sign-in problems
- Install and update problems
- Chat panel problems
- Agent run problems
- Connector problems
- Dictation problems
- Usage, billing and network errors
- CLI problems