Docs/Reference
Files & directories
Where Gray keeps config, keys, sessions, skills, plugins, memory, cron jobs and logs under ~/.gray.
Everything lives under GRAY_HOME, which defaults to ~/.gray. Credential and transcript files are written with 0600 permissions.
| Path | Holds |
|---|---|
| config.json | model, provider and other persisted settings |
| auth.json | provider keys (0600) |
| registry-token.json | gray.alignment.id token (0600) |
| AGENTS.md | the system prompt — /agentsmd edits it |
| sessions/ | JSONL transcripts |
| memory/ | user.md and one file per project |
| skills/ | global skills |
| plugins/ · plugins/lock.json | installed plugins and their lock |
| cron/jobs.json | scheduled jobs |
| shell/<session>/ | full logs of every bash call |
| gateway.sock · gateway.pid · gateway.state.json | the gateway daemon |
| feedback/ | local copies of /feedback |
| logs/gray.log | the log, rotated by size |
In a project
| Path | Holds |
|---|---|
| AGENTS.md · CLAUDE.md | project rules sent every turn |
| .gray/skills/ | project skills |
| .gray/plugins.json | project plugin overlay |
| gray.yml | tool profile |
Join the Discord
Chat with the people building and running Gray. Show what you made with it.
Join Discord →