Install Evo

Accounts, the install and the agent connection are open today. Nobody has frozen a compiler through the service yet — that is the one piece still to land, and it is the only one.

macOS, Linux, WSL v0.1.33

curl -fsSL --proto '=https' --proto-redir '=https' https://api.evocompiler.com/install.sh | sh

Click the line to select all of it · ⌘C to copy. Tap and hold the line to select it, then choose Copy.

Or fetch it, read it, then run it — piping a script into a shell is a request for trust, and this one is short enough to read first.

Read it first

curl -fsSLO --proto '=https' --proto-redir '=https' https://api.evocompiler.com/install.sh
less install.sh
sh install.sh

Windows PowerShell v0.1.33

irm https://api.evocompiler.com/install.ps1 | iex

Click the line to select all of it · ⌘C to copy. Tap and hold the line to select it, then choose Copy.

Or fetch it, read it, then run it — piping a script into a shell is a request for trust, and this one is short enough to read first.

Read it first on Windows

powershell -NoProfile -Command "iwr -UseBasicParsing https://api.evocompiler.com/install.ps1 -OutFile install.ps1"
notepad install.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

That’s it.

The installer does the rest, and it is safe to run again:

It installs evolve, which manages your projects, and evocc, the compiler driver you call in place of gcc.
It opens a browser and signs this machine in.
It connects the coding agents it finds here — Claude Code, Codex, Cursor.

After that

Open your project and tell your agent:

Use Evo to make this faster.

If it has not met Evo before, hand it this instead. It is one line and it points at the documentation written for agents rather than for you.

For your agent

Read https://evocompiler.com/agent.md and use Evo to optimize this project.

If you are going to tune on an embedded target, read this first.
Tuning builds many versions of your program and runs each one on the real part. The board must be completely disconnected from anything around it while that happens — nothing wired to its pins, nothing it can drive. What that means and why.

Something weird?

Nothing happened after “Opening browser”

Run evolve setup again. It picks up where it stopped and changes nothing that is already correct.

Over SSH, or on a machine with no browser

evolve auth login --no-browser gives you a code to carry to a browser anywhere. It has to be asked for: opening a local port succeeds on that machine too, and nothing else can tell the difference.

My agent is not listed

evolve setup re-scans. Supported today: Claude Code, Codex and Cursor. If yours is not one of them, the connection is an address and a credential and you can make it by hand — the commands are here.

I want to do it by hand

Every step the installer takes has a command behind it, and they are all on the reference page — sign in, connect an agent, make a project, register something to measure on.

What did it change?

evolve setup --explain prints every file it would touch and makes no change. evolve auth status says who this machine is signed in as, and evolve auth logout ends the session — it revokes the credential rather than only forgetting it.

Checking the download yourself

The installer already checks every file against the published checksums before it unpacks anything, and installs nothing it cannot check. This is here because you can.

shasum -a 256 -c --ignore-missing SHA256SUMS

--ignore-missing matters: that file lists every published build and you have one, so without it the other 3 would be reported as failures. Version 0.1.33.

How it works · Reference · Sign in · Back