# AgentConfig

<!-- https://uncage.vercel.app/docs/api/agent/interfaces/agentconfig/ -->

Defined in: agent/src/config.ts:126

## Properties

| Property | Type | Description | Defined in |
| ------ | ------ | ------ | ------ |
| <a id="property-localpolicy"></a> `localPolicy` | `object` | - | agent/src/config.ts:128 |
| `localPolicy.allowBypass` | `boolean` | - | agent/src/config.ts:128 |
| `localPolicy.allowedPermissionModes?` | (`"default"` \| `"auto"` \| `"acceptEdits"` \| `"plan"` \| `"bypassPermissions"`)[] | - | agent/src/config.ts:128 |
| <a id="property-runtimes"></a> `runtimes?` | `object` | Always set by `loadAgentConfig`; optional so hand-built configs (tests) may leave it out. | agent/src/config.ts:130 |
| `runtimes.acp` | `object` | - | agent/src/config.ts:130 |
| `runtimes.acp.agents` | `object`[] | - | agent/src/config.ts:103 |
| `runtimes.acp.autoDetect` | `boolean` | Detect installed agents from the official ACP registry (handshake-checked). `false`: no detection and no handshakes; only `agents`, presets and `enable`d registry agents register. | agent/src/config.ts:72 |
| `runtimes.acp.consented` | `Record`\<`string`, \{ `args`: `string`[]; `cmd?`: `string`; `env`: `Record`\<`string`, `string`\>; `package?`: `string`; `runner`: `"local"` \| `"npx"` \| `"uvx"`; \}\> | Exactly what each `uncage runtimes enable` consented to run: the runner (`local` command, `npx`, `uvx`), the command or package name (any version), args and env. If the registry later changes any of these, the agent needs `enable` again. | agent/src/config.ts:80 |
| `runtimes.acp.disable` | `string`[] | Registry, preset or runtime ids never registered (`uncage runtimes disable <id>`). | agent/src/config.ts:102 |
| `runtimes.acp.enable` | `string`[] | Registry ids the user consented to run (`uncage runtimes enable <id>`), e.g. npx/uvx agents. | agent/src/config.ts:74 |
| `runtimes.acp.presets` | `"auto"` \| `"off"` | `auto`: register the Claude Code / Gemini CLI / OpenCode presets whose command is on PATH. | agent/src/config.ts:67 |
| <a id="property-sites"></a> `sites` | `object`[] | - | agent/src/config.ts:127 |
