Fields
integer
The file version the config is written in. Omitted means 1;
graph config migrate brings a file to the current version.object
Runtime settings.
string
default:"~/.local/share/graph"
Where threads and the shape cache are stored.
integer
default:"15"
Most model rounds a conversation agent takes in one turn.
integer
default:"2"
Attempts the built-in planner gets before giving up.
integer
default:"20"
Most past messages sent with each turn.
object
Named provider connections, as
[providers.<name>].enum<string>
required
The provider.
systemone serves decision models.Available options: anthropic, openai, openai_compat, systemonestring
API key, usually
${ENV_VAR}.string
Endpoint for
openai_compat and self-hosted providers.string
Cloud region, where the provider needs one.
string
Credentials profile, where the provider uses one.
object
Model roles, as
[models.<role>]. Standard roles are default, chat, planner, outliner, solver, repair, judge and decider; any other name is a custom role.string
required
A name from
[providers].string
required
The provider’s model id.
number
Sampling temperature.
string
What the role is for. Roles with a description are offered to drafters and steps by name.
integer
The model’s context window in tokens.
object[]
Models to try, in order, when this one fails.
string
required
A name from
[providers].string
required
The provider’s model id.
number
Sampling temperature.
integer
The model’s context window in tokens.
object
MCP servers, as
[mcp.<name>]. Their tools join the catalog as <name>__<tool>.string
What the server is for, read by drafters choosing tools.
string
Executable for a stdio server. Use
command or url, not both.string[]
Arguments for
command.map<string, string>
Environment for a stdio server. Values expand
${VAR}.string
Endpoint for a streamable HTTP server.
map<string, string>
HTTP headers. Values expand
${VAR}.string[]
Load only these tools.
string[]
Skip these tools.
object
Per-tool corrections, as
[mcp.<name>.tool_overrides.<tool>].string
Replaces the server’s description of the tool.
object
The tool’s output shape.
object
An example of the tool’s output.
object
Where plans are loaded from.
string[]
default:"- ./.graph/plans\n- ~/.config/graph/plans"
Plan directories, searched in order.
object
Where tools come from.
string[]
default:"- ./.graph/tools\n- ~/.config/graph/tools"
Tool directories, searched in order.
string[]
default:"- builtin__infer\n- builtin__reshape"
Tools always offered to drafters, whatever the search returns.
object
Installed packs, as
[packs.<name>]. Their tools, plans and agents join the catalog as <name>__<kind>__<item>.string
required
The git repository the pack is installed from.
string
The pack’s directory inside the repository, such as
github. Its releases are the tags <path>/vX.Y.Z. The repository root when absent.string
The release line (
v1), exact release (v1.2.0) or branch to install. Release refs name the pack’s own version; graph adds the <path>/ tag prefix.string[]
Glob patterns over
<kind>__<item>, such as plan__*, naming the items callable from outside the pack. Everything when empty.string[]
Glob patterns over
<kind>__<item> for items only the pack’s own plans and agents can call.object
Where graph keeps state.
enum<string>
default:"file"
memory keeps nothing between runs. GRAPH_STORAGE overrides it.Available options: file, memoryobject
About you, for agent prompts.
string
Your name.
string
Anything agents should know about you.
string
Your timezone, such as
America/New_York.object
Deprecated. Customize agents with agent files instead.
string
Deprecated.
string
Deprecated.
object
Workbench settings.
string
Where the workbench writes its log. Defaults to
<data_dir>/workbench.log; GRAPH_WORKBENCH_LOG overrides it.object
OpenTelemetry export over OTLP/HTTP.
string
The OTLP/HTTP endpoint. Telemetry is off without one.
enum<string>
default:"http/protobuf"
Wire format.Available options:
http/protobuf, http/jsoninteger
Export timeout in seconds.
string
The
service.name resource attribute.map<string, string>
Headers sent with every export, such as auth.
map<string, string>
Extra resource attributes.
boolean
default:"true"
Include prompts and responses in spans.
boolean
default:"false"
Export logs as well as traces.
object
Prices per model id, as
[pricing."<model>"], in USD per million tokens. Without them, usage is reported in tokens only.number
required
Input tokens.
number
required
Output tokens.
number
Cache-write tokens.
number
Cache-read tokens.