Gray

The agent harness that stays small.

One binary. Bash only. Your keys, any provider, a context window that looks after itself — and nothing you didn't ask for.

These docs cover everything Gray does today. Every page names the source it was written from, so if the docs and the binary ever disagree, the binary wins.

Install

shell
$curl -fsSL https://gray.alignment.id/install.sh | sh

Run

shell
$cd your-project && gray
Explore the quickstart guide →

Small core. Open world.

Start small.
Extend anything.

How it fits together →
  • toolsbash. Everything else is a shell away.1
  • binaryStatic. No runtime, no services.1
  • providersBuilt in, plus any OpenAI-compatible URL.11+
  • plugin wireNDJSON over stdio. Frozen.v1
  • contextResolves, compacts and retries itself.auto
  • licenseRead every line of it.MIT
See every command and flag →

Providers. Bring your own key.

Context. How it holds up.

Resolve

Knows its window.

Flag, then provider, then the LiteLLM table, then a fallback. You never type a context size unless you want to.

Compact

Summarizes before the wall.

Near the limit, older turns fold into a summary and the recent tail stays verbatim. Overflow errors compact and retry once.

Resume

Picks up mid-thought.

Every turn lands in a JSONL tree on disk. Interrupted, crashed, closed — gray -c is back where you were.

See how compaction works →

The docs. End to end.

What's next.

Read the changelog →

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 →