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
$curl -fsSL https://gray.alignment.id/install.sh | sh
Run
$cd your-project && gray
Small core. Open world.
Start small.
Extend anything.
- 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
- Resume any conversation. Where it stopped.→
- Context that manages itself.→
- Remember what matters. Forget the rest.→
- Skills. Written once. Run forever.→
- Paste a screenshot. Show it a chart.→
- Jobs in the background. Turns stay free.→
- Schedule it. Walk away.→
- Script it. Pipe it. Ship it.→
- Plug into anything.→
- Cap the turns, the dollars, the clock.→
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.
The docs. End to end.
What's next.
Quickstart
Your first real task. Step by step.
CLI reference
Every subcommand. Every flag.
Writing a plugin
The wire, the methods, the checker.
Print mode & JSON
Gray inside scripts and CI.
Join the Discord
Chat with the people building and running Gray. Show what you made with it.
Join Discord →