Docs/Tools
Bash tool
One tool by default: bash. Read, search, edit and run commands through a single surface, with no tool sprawl and no per-tool approval prompts.
Source: crates/gray-tools
Gray's default tool surface is a single bash tool. The model reads with cat and sed, searches with rg and fd, edits with heredocs, and runs whatever the task needs. It schedules its own recurring work with gray cron add and looks at images with gray view — through the same tool.
How a call runs
- —The model streams a tool call; Gray runs it in the session's working directory with a cancellation token. Ctrl-C kills the process tree.
- —Every call's full output is written to
~/.gray/shell/<session>/bash-<id>.log, and the result header names that path, so the agent can grep a long log instead of re-running the command. - —Calls have no default timeout. An explicit
timeoutis capped at 3600 seconds. - —Read-only tool calls run concurrently, results in input order.
GRAY_PARALLEL_READS=0runs every call in sequence.
Want dedicated file tools instead? A tool profile swaps in read, write, edit, grep, find and ls. For long-running commands see Background jobs.
Join the Discord
Chat with the people building and running Gray. Show what you made with it.
Join Discord →