Getting 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.
Run Gray with no arguments. The first run drops you straight at the prompt — it does not force an onboarding wizard, a login, or a model choice on you.
$grayConfigure whenever you feel like it. /connect walks through providers (free tier, API key, or a local endpoint), /login enrolls an optional gray.alignment.id account, and /model opens a searchable picker over the bundled models.dev catalog.
Other entry points
echo "hi" | gray -p "one-line summary of this repo" # print mode, for scripts gray -c # resume the last session
Ctrl-C means cancel mid-turn on the first press and exit at the prompt. An interrupted turn still persists whatever reached memory, so resuming never loses the part that already streamed.