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 gray in 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 /connect and pick a provider. Paste an API key (input is hidden), use a free tier, or point at a local endpoint like Ollama.
  • 04Run /model and 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

Join the Discord

Chat with the people building and running Gray. Show what you made with it.

Join Discord →

Need help?

Open an issue on GitHub, run /feedback from the REPL, or ask in Discord.

Open an issue →