Skip to content

Configure the CLI

GthonrAgents stores configuration under ~/.gthonragents/config.toml by default.

Terminal window
gthonragents config show
gthonragents config get <key>
gthonragents config set <key> <value>
gthonragents config unset <key>

Common settings:

Key Purpose Default
endpoint GthonrAgents server URL GthonrAgents production API
auto_update Check CLI updates on launch true
feedback Enable direct feedback commands true

Use GTHONRAGENTS_CONFIG_DIR when the home directory is read-only, ephemeral, or intentionally isolated:

Terminal window
export GTHONRAGENTS_CONFIG_DIR=./.gthonragents
gthonragents status

Relative paths are resolved to absolute paths. The directory contains CLI state, credentials or keyring fallback data, and update markers. Do not commit it.

Set the endpoint for one command:

Terminal window
gthonragents --endpoint https://example.internal status

Or persist it:

Terminal window
gthonragents config set endpoint https://example.internal

Commands write one final JSON document to stdout. Use normal shell redirection or jq; do not wrap MCP stdio with scripts that print banners to stdout.