Docs › Reference › Commands

Commands

Every AstraCode command in the command palette, what it does, and its keyboard shortcut.

On this page

Open the command palette with Cmd+Shift+P (Ctrl+Shift+P on Windows and Linux) and type AstraCode to see these. Most are also on a button or a menu, named in the table.

Chat

CommandWhat it doesShortcut
AstraCode: Open ChatOpens the chat, as an editor tab or in the sidebar depending on astracode.chatAsEditorTabs. If the sidebar chat is already showing, it focuses that one.Cmd+Shift+I (Ctrl+Shift+I)
AstraCode: Toggle ChatCloses the chat when it is showing; otherwise opens it in the sidebar.Opt+Cmd+J (Ctrl+Alt+J)
New ChatStarts a new chat in a new tab.Opt+Cmd+N (Ctrl+Alt+N)
AstraCode: Focus Chat InputPuts the cursor in the chat's message box.Cmd+Opt+I (Ctrl+Alt+I)
Chat HistoryOpens the list of past chats, with search.None
Export TranscriptOpens the current chat as a Markdown document you can save.None
AstraCode: Compact SessionSummarises the conversation so far to free context. Also Compact session in the context ring.None
AstraCode: Add Selection to ChatAttaches the editor selection to the chat. Also in the editor's right-click menu.Opt+K (Alt+K)
AstraCode: Add to ChatAttaches a file. In the Explorer and editor tab right-click menus it attaches the files you picked; from the palette, the open file.None
AstraCode: Add to Chat (terminal)Attaches the terminal's selection, or its last command and output. Also in the terminal's right-click menu.Cmd+L or Opt+K (Ctrl+L or Alt+K), with text selected
AstraCode: Add Problems to ChatAttaches the errors and warnings from the Problems panel.None
AstraCode: Ask About This SelectionStarts a new chat with a question about the selection in the box.None

Editing and reviewing

CommandWhat it doesShortcut
AstraCode: Edit SelectionAsks what the selected code should do instead and changes it in place, for you to keep or undo. Also in the editor's right-click menu with text selected.None
AstraCode: Keep the Agent's Change at the CursorKeeps the undecided change the cursor is in.Cmd+Y (Ctrl+Y)
AstraCode: Undo the Agent's Change at the CursorUndoes the undecided change the cursor is in.Cmd+N (Ctrl+N)
AstraCode: Next ChangeMoves to the next change waiting for review.Opt+Cmd+] (Ctrl+Alt+])
AstraCode: Previous ChangeMoves to the previous change waiting for review.Opt+Cmd+[ (Ctrl+Alt+[)
AstraCode: Review Agent ChangesOpens the review of every change still waiting, with Accept and Reject per file and for all.None
AstraCode: Find Issues in Agent ChangesReviews the changes still waiting for problems and puts what it finds in the Problems panel.None

See Reviewing the agent's changes and Edit and ask about a selection.

Git

CommandWhat it doesShortcut
AstraCode: Write Commit MessageWrites a commit message for the staged changes into the Source Control box. It never commits. Also a button in that box.None
AstraCode: Review This BranchReviews everything on the branch since it left its base. Also a button in the Source Control title bar.None
AstraCode: Resolve Conflicts in ChatSaves the file and asks the agent to resolve its merge conflicts. Shown in the editor title bar when the file has conflicts.None
AstraCode: Enable remote agents for this repositoryWrites .github/workflows/astracode-agent.yml and shows it as a diff, then lists what is left for you: commit it, and allow GitHub Actions to create pull requests. It never commits or pushes.None

See Git and Remote agents in GitHub Actions.

Account

CommandWhat it doesShortcut
AstraCode: Sign InSigns in through your browser.None
AstraCode: Sign UpThe same, starting on the sign-up page.None
AstraCode: Sign In with a TokenStores a token issued by your organisation's own gateway. For gateway operators.None
AstraCode: Use My Own API Key (optional)Adds or removes your own provider key. See Bring your own key.None
AstraCode: Upgrade PlanOpens the upgrade page on the site.None
AstraCode: Connect GitHubOpens your dashboard's integrations page on the site.None

To sign out, use Log out in AstraCode Settings > General. See Signing in.

Connectors

CommandWhat it doesShortcut
AstraCode: MCP: Add ConnectorLists the built-in connectors to add.None
AstraCode: MCP: Edit ServersOpens astracode.mcp.servers in your settings.None
AstraCode: MCP: Show Connection LogOpens the AstraCode MCP log: connectors, updates and first-run setup.None
AstraCode: MCP: Forget Approved Organisation ServersForgets the servers you approved, from your organisation and from projects in every workspace, so each asks again.None

See Connectors.

Browser

CommandWhat it doesShortcut
AstraCode: Open BrowserOpens the browser panel beside the editor.Cmd+Shift+Opt+B (Ctrl+Shift+Alt+B)
AstraCode: Reload BrowserReloads the page in the browser panel.None
AstraCode: Open Current Page in External BrowserOpens the panel's page in your own browser.None

Setup, help and maintenance

CommandWhat it doesShortcut
AstraCode: Open SettingsOpens AstraCode Settings.None
AstraCode: Choose ThemePreviews and picks Dark, Light or Match System; Escape puts the old one back.None
AstraCode: Set Up ExtensionsPicks popular extensions from Open VSX to install.None
AstraCode: Install 'astra' Command in PATHOn macOS, links astra and astracode-update onto your PATH, asking for your administrator password if it has to.None
AstraCode: Check for UpdatesChecks for a new version now. See Updates.None
AstraCode: Create AGENTS.md for this projectDrafts an AGENTS.md from the project's files for you to edit and save. See Rules.None
AstraCode: Show Completion StatsShows how many tab suggestions were shown, accepted and avoided, and how fast they were.None
AstraCode: Show Agent LogOpens the AstraCode Agent log.None
AstraCode: Report a ProblemWrites up what went wrong, shows it to you, and sends it to support. See Reporting a problem and getting help.None
AstraCode: Repair the Chat PanelClears the editor's web view cache and reloads, for a blank chat panel. Chats and settings are kept.None

Commands that appear only in menus

These are not in the command palette; they sit on buttons where they apply.

CommandWhereWhat it does
Keep and UndoThe gutter of a changed block in a review diffKeep or undo that block.
Keep File and Undo FileThe title bar of a review diff, and each file in the multi-file reviewKeep or undo every change in that file.
Keep All and Undo AllThe title bar of the multi-file reviewKeep or undo every waiting change.
Add to ChatRight-click a row in the Problems panelAttaches that problem, or that file's problems.

← Keyboard shortcuts Models and AstraOne →

All documentation

Get started

Using the editor

Agent

Context

Workspaces

Connectors

Extending AstraCode

CLI

Account and usage

Troubleshooting

Reference