from zero to your first task

Get started in minutes.

Four steps: install, configure provider and key, run the first commands, and keep going. No secrets.

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

Recommended terminal: WezTerm — the terminal best suited to run the Aluy CLI (best glyph rendering for the TUI; otherwise run with --ascii).

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

a · provider

Broker by default, or a direct provider (with your own credential). Switch later with /provider.

b · key

The credential goes straight to the OS vault — never in plain text, never in the repo. You won't type it again.

c · model

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

validate · /doctor

Run /doctor to confirm model, key, connection and tools — read-only, with a fix hint.

$ aluy opens the session in this project

/doctor checks install health

/init prepares deps and the project's AGENT.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