Commands
Every AstraCode command in the command palette, what it does, and its keyboard shortcut.
On this page
- Chat
- Editing and reviewing
- Git
- Account
- Connectors
- Browser
- Setup, help and maintenance
- Commands that appear only in menus
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
| Command | What it does | Shortcut |
|---|---|---|
| AstraCode: Open Chat | Opens 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 Chat | Closes the chat when it is showing; otherwise opens it in the sidebar. | Opt+Cmd+J (Ctrl+Alt+J) |
| New Chat | Starts a new chat in a new tab. | Opt+Cmd+N (Ctrl+Alt+N) |
| AstraCode: Focus Chat Input | Puts the cursor in the chat's message box. | Cmd+Opt+I (Ctrl+Alt+I) |
| Chat History | Opens the list of past chats, with search. | None |
| Export Transcript | Opens the current chat as a Markdown document you can save. | None |
| AstraCode: Compact Session | Summarises the conversation so far to free context. Also Compact session in the context ring. | None |
| AstraCode: Add Selection to Chat | Attaches the editor selection to the chat. Also in the editor's right-click menu. | Opt+K (Alt+K) |
| AstraCode: Add to Chat | Attaches 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 Chat | Attaches the errors and warnings from the Problems panel. | None |
| AstraCode: Ask About This Selection | Starts a new chat with a question about the selection in the box. | None |
Editing and reviewing
| Command | What it does | Shortcut |
|---|---|---|
| AstraCode: Edit Selection | Asks 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 Cursor | Keeps the undecided change the cursor is in. | Cmd+Y (Ctrl+Y) |
| AstraCode: Undo the Agent's Change at the Cursor | Undoes the undecided change the cursor is in. | Cmd+N (Ctrl+N) |
| AstraCode: Next Change | Moves to the next change waiting for review. | Opt+Cmd+] (Ctrl+Alt+]) |
| AstraCode: Previous Change | Moves to the previous change waiting for review. | Opt+Cmd+[ (Ctrl+Alt+[) |
| AstraCode: Review Agent Changes | Opens the review of every change still waiting, with Accept and Reject per file and for all. | None |
| AstraCode: Find Issues in Agent Changes | Reviews 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
| Command | What it does | Shortcut |
|---|---|---|
| AstraCode: Write Commit Message | Writes 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 Branch | Reviews everything on the branch since it left its base. Also a button in the Source Control title bar. | None |
| AstraCode: Resolve Conflicts in Chat | Saves 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 repository | Writes .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
| Command | What it does | Shortcut |
|---|---|---|
| AstraCode: Sign In | Signs in through your browser. | None |
| AstraCode: Sign Up | The same, starting on the sign-up page. | None |
| AstraCode: Sign In with a Token | Stores 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 Plan | Opens the upgrade page on the site. | None |
| AstraCode: Connect GitHub | Opens your dashboard's integrations page on the site. | None |
To sign out, use Log out in AstraCode Settings > General. See Signing in.
Connectors
| Command | What it does | Shortcut |
|---|---|---|
| AstraCode: MCP: Add Connector | Lists the built-in connectors to add. | None |
| AstraCode: MCP: Edit Servers | Opens astracode.mcp.servers in your settings. | None |
| AstraCode: MCP: Show Connection Log | Opens the AstraCode MCP log: connectors, updates and first-run setup. | None |
| AstraCode: MCP: Forget Approved Organisation Servers | Forgets the servers you approved, from your organisation and from projects in every workspace, so each asks again. | None |
See Connectors.
Browser
| Command | What it does | Shortcut |
|---|---|---|
| AstraCode: Open Browser | Opens the browser panel beside the editor. | Cmd+Shift+Opt+B (Ctrl+Shift+Alt+B) |
| AstraCode: Reload Browser | Reloads the page in the browser panel. | None |
| AstraCode: Open Current Page in External Browser | Opens the panel's page in your own browser. | None |
Setup, help and maintenance
| Command | What it does | Shortcut |
|---|---|---|
| AstraCode: Open Settings | Opens AstraCode Settings. | None |
| AstraCode: Choose Theme | Previews and picks Dark, Light or Match System; Escape puts the old one back. | None |
| AstraCode: Set Up Extensions | Picks popular extensions from Open VSX to install. | None |
| AstraCode: Install 'astra' Command in PATH | On macOS, links astra and astracode-update onto your PATH, asking for your administrator password if it has to. | None |
| AstraCode: Check for Updates | Checks for a new version now. See Updates. | None |
| AstraCode: Create AGENTS.md for this project | Drafts an AGENTS.md from the project's files for you to edit and save. See Rules. | None |
| AstraCode: Show Completion Stats | Shows how many tab suggestions were shown, accepted and avoided, and how fast they were. | None |
| AstraCode: Show Agent Log | Opens the AstraCode Agent log. | None |
| AstraCode: Report a Problem | Writes 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 Panel | Clears 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.
| Command | Where | What it does |
|---|---|---|
| Keep and Undo | The gutter of a changed block in a review diff | Keep or undo that block. |
| Keep File and Undo File | The title bar of a review diff, and each file in the multi-file review | Keep or undo every change in that file. |
| Keep All and Undo All | The title bar of the multi-file review | Keep or undo every waiting change. |
| Add to Chat | Right-click a row in the Problems panel | Attaches that problem, or that file's problems. |
← Keyboard shortcuts Models and AstraOne →
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