Support & FAQ

Expected for now — the installer isn't code-signed yet (that costs a yearly Apple Developer fee, which isn't worth it before the language has real users). To open it anyway: right-click the downloaded .pkg → Open, then confirm in the dialog that appears. You only need to do this once.

Installing a system package needs admin rights. Use sudo:

sudo dpkg -i upgrade-lang_0.1.0_amd64.deb

On Fedora/RHEL-based systems, use the .rpm instead:

sudo rpm -i upgrade-lang-0.1.0-1.x86_64.rpm

This is rare since the installer places upgrade in a standard system location (/usr/bin on Linux, /usr/local/bin on macOS), both already on PATH by default. If it still doesn't show up, open a fresh terminal window first — some shells cache the command list from before the install.

No. Everything Upgrade needs is bundled into the installer — there's nothing else to install, and nothing else on your machine to keep updated for Upgrade to keep working.

If your program calls do api.serve, that's expected — it starts a real local web server and blocks on purpose. Press Ctrl+C to stop it. If it's not an API program, you may have an infinite loop (e.g. a repeat count that's never reached); the IDE has a 5-second safety timeout for this, but the plain command line does not.

This shouldn't happen — every Upgrade error is designed to come back in plain English. If you see a raw traceback, that's a bug worth reporting — see "Still stuck?" below, with the exact program that triggered it.

Check the terminal output for a line like Upgrade IDE running at http://127.0.0.1:5500 and open that address manually.

Something else is using port 5500. Run it on a different port:

upgrade ide 5600

No. By default it gives a useful rule-based explanation instantly, fully offline. Opting in to a real AI-generated explanation requires setting an API key environment variable yourself — it's never on by default.