Docs/Get started
Quickstart
From a fresh install to your first working AI agent conversation — connect a provider, pick a model, and start a session in a few steps.
- 01Install Gray —
curl -fsSL https://gray.alignment.id/install.sh | sh. - 02Run
grayin the directory you want to work in. The first run drops you straight at the prompt: no forced onboarding wizard, no login, no model choice. - 03Run
/connectand pick a provider. Paste an API key (input is hidden), use a free tier, or point at a local endpoint like Ollama. - 04Run
/modeland pick a model from the searchable catalog. - 05Type what you want done and press Enter. Gray streams the answer, and the commands it runs, as they happen.
bash
$gray
Other entry points
bash
$gray -p "one-line summary of this repo" # print mode, for scripts$gray -c # resume the last session$gray resume # pick any earlier session
Ctrl-C cancels a running turn. At the prompt it clears the draft; a second press on an empty prompt exits. An interrupted turn keeps whatever already reached memory, and pressing Enter on the empty prompt asks Gray to continue it.
Where to go next
- —Interactive mode — keys, completion, paste and the footer.
- —Bash tool — how the agent actually does work.
- —Skills — teach it a procedure once.
- —Print mode & JSON — run it from scripts and CI.
Join the Discord
Chat with the people building and running Gray. Show what you made with it.
Join Discord →