Docs › Get started › Updates

Updates

How AstraCode updates itself, the settings that control it, and how to update from a terminal.

On this page

AstraCode looks for new versions on its own and, where it can, downloads them in the background. It never restarts by itself: the new version is installed only when you choose Restart and Update.

How it works

Every update is checked before it is installed: it must match the checksum published with it, and on macOS and Windows it must be signed by the same publisher as the copy you have. If a check fails, nothing changes.

What each install does

Installed fromHow it updates in the editor
macOS .dmg or HomebrewDownloads and is verified in the background; installs when you choose Restart and Update.
Windows installerDownloads and is verified in the background; Restart and Update runs the new installer and reopens AstraCode. The system installer shows the administrator prompt.
Linux .tar.gz, extracted as youDownloads and is verified in the background; installs when you choose Restart and Update.
Linux .deb or .rpmYour package manager owns it. The notice's Update now upgrades it through apt or dnf. See Linux packages below.
Windows zip, or a copied folderCannot update itself. Install with the installer from the download page.

The status bar

Status barMeaningPress it to
Update availableA new version exists.Check now and get the update. AstraCode: Check for Updates does the same.
Update readyThe new version is downloaded.Restart into it.
Update needs youIt could not be installed automatically. The tooltip says why.See the options.

Settings

astracode.updates.mode chooses how much the editor does:

ValueWhat happens
automatic (default)Check, download in the background, and offer Restart and Update. A copy that cannot update itself behaves as notify.
notifyCheck, and tell you when a version is out: AstraCode X is available. You have Y. with Download, What's new (when the release has notes) and Ignore this version.
offDo not check.

The older setting astracode.updates.check is still honoured: false means off.

Checking now

  1. Run AstraCode: Check for Updates, or choose Check for Updates in AstraCode Settings, General.
  2. The editor says AstraCode X is the latest version., or starts downloading the new one, or offers to restart into one already downloaded.

Ignoring a version

Choose Ignore this version on the notification, and AstraCode stops offering that version. It asks again when the next one comes out. A check you run yourself with Check for Updates forgets the choice and offers it again. Later just closes the notification; the status bar keeps saying Update ready.

Linux packages

A copy installed from a .deb or .rpm belongs to your package manager, so the editor never swaps its files. When a version is out, the notice offers Update now: it opens a terminal in the editor and upgrades AstraCode through apt or dnf, which asks for your password. Restart AstraCode when it finishes.

If the machine does not have the AstraCode apt or dnf repository yet, the first update adds it, so later versions also arrive with your system's own updates. The same happens when you run astracode-update in a terminal.

Updating from a terminal

Each platform has one update command. Every one of them accepts --check, which says what is available and changes nothing, and every one works even when the editor will not start.

Installed fromCommand
macOSastra -update, once you have run AstraCode: Install 'astra' Command in PATH. Without it: /Applications/AstraCode.app/Contents/Resources/app/bin/astracode -update
Windowsastracode -update in PowerShell or Command Prompt. The installer puts astracode on your PATH; open a new terminal after installing.
Linux .deb or .rpmastracode-update, or astracode -update
Linux .tar.gz./bin/astracode -update from the folder you extracted, as the user who owns it

Terminal

astra -update             # macOS: update if a newer version is out
astra -update --check     # say what is available, change nothing

The terminal update makes the same checks as the editor; if one fails, nothing is installed. Close AstraCode before updating it from a terminal.

Where updates are kept

Downloads wait in ~/Library/Caches/AstraCode/updates on macOS and Linux, and %LOCALAPPDATA%\AstraCode\updates on Windows. The editor clears old ones itself. Update messages are written to the AstraCode MCP output channel; open it with AstraCode: MCP: Show Connection Log.

If something goes wrong

Every message, with its fix, is in Install and update problems.

← The chat panel Tab completion →

All documentation

Get started

Using the editor

Agent

Context

Workspaces

Connectors

Extending AstraCode

CLI

Account and usage

Troubleshooting

Reference