Skip to main content
Augent loads user defaults from ~/.augent/config.yaml on startup. Every setting is optional — if the file doesn’t exist, Augent uses sensible defaults. Per-call arguments always override config values.

Example config


Disabling tools

If you don’t use certain tools, you can hide them from Claude (or any MCP client) so they don’t clutter the tool list:
Disabled tools are removed from the tools/list response and cannot be called. To re-enable, remove them from the list and restart Claude Code.

Config format

Augent tries ~/.augent/config.yaml first (requires PyYAML). If PyYAML isn’t installed, it falls back to ~/.augent/config.json:

Available tools

These are the tool names you can use in disabled_tools:
Restart Claude Code after editing config. The MCP server reads the config once on startup.