from zero to your first task

Get started in minutes.

Three steps: install, set your provider and key, run the first commands. At the end, a map of where to go next. Nothing hidden.

1

Install

download & install
bash — install aluy
$ curl -fsSL https://aluy.dev/install.sh | bash
1 line · no sudo·installs to ~/.aluy·re-run to update
Linux · macOS · Windows Node ≥ 20 ~150 MB free connection for the 1st run

Aluy renders best in WezTerm: the icons and borders come out visually more refined. It works the same in other terminals, just plainer.

2

Configure — provider, key & model

On the first run, a wizard opens. You choose the provider, paste the key and pick the model — in that order.

/provider

the provider

Your own provider, with your own credential — you bring your own key. This is the default. Switch later with /provider.

keyring

the key

The credential goes straight to the OS vault — or an encrypted file, on a machine without one. Never in plain text, never in the repo. You won't type it again.

/model

the model

Pick the tier with /model. Tune reasoning effort with /effort when needed.

Check it before the first task.

Run /doctor to confirm model, key, connection and tools — read-only, with a fix hint when something is out of place.

3

Open the session and try it

$ aluy opens the session in this project
/doctor checks install health
/init reads the repo and writes its ALUY.md
/cycle "run the tests and fix what breaks"
/memory list what the agent already remembers here
/ opens the menu Ctrl+P opens the palette /help lists everything

Where to go now