Configure the CLI
Configuration file
Section titled “Configuration file”GthonrAgents stores configuration under ~/.gthonragents/config.toml by default.
gthonragents config showgthonragents 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 |
Custom config directory
Section titled “Custom config directory”Use GTHONRAGENTS_CONFIG_DIR when the home directory is read-only, ephemeral, or intentionally isolated:
export GTHONRAGENTS_CONFIG_DIR=./.gthonragentsgthonragents statusRelative paths are resolved to absolute paths. The directory contains CLI state, credentials or keyring fallback data, and update markers. Do not commit it.
Endpoint override
Section titled “Endpoint override”Set the endpoint for one command:
gthonragents --endpoint https://example.internal statusOr persist it:
gthonragents config set endpoint https://example.internalMachine-readable output
Section titled “Machine-readable output”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.
