> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentgg.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Where agentgg stores its config, how to read it, and how it differs from scan state.

## Where the config lives

`agentgg init` writes the saved config to `~/.agentgg/config.json`. It holds your provider, model, and mode defaults.

## Read the config

Run `agentgg config` to print the saved config. It masks secrets. Pass `--json` for machine-readable output.

See [Commands](/cli/reference/commands) for the full flag list, including how to change the default provider or model.

## Add a second provider

Run `agentgg init` again to add another provider. It merges the new provider into the config and does not overwrite the first one.

## The agent catalog

`agentgg` keeps agents in two places:

| Location                     | Purpose                                                           |
| ---------------------------- | ----------------------------------------------------------------- |
| `~/.agentgg/agentgg-agents/` | The official agent catalog. `agentgg agents update` refreshes it. |
| `~/.agentgg/agents/custom/`  | Agents you install yourself with `agentgg agents add`.            |

## Scan state is separate

<Info>
  Scan state lives in the output directory you pass to `-o`, not in `~/.agentgg/config.json`. You can delete the config file and keep every scan result.
</Info>