Agent Declaration

Agents are declared in kg.toml files using the [agents] table.

Basic Declaration

[agents]
default = { inherits = [] }

The key (default) is the agent name. This creates an agent that looks for configuration in:

List of parent agents to inherit configuration from.

[agents]
default = { inherits = [] }
rust = { inherits = ["default"] }
python = { inherits = ["default"] }

Mark an agent as a template that won’t generate a JSON file.

[agents]
git-base = { skeleton = true }

See Skeletons for details.

You can define agent configuration inline or in separate files:

Inline:

[agents.default]
inherits = []
allowedTools = ["read", "knowledge"]

External:

[agents]
default = { inherits = [] }

Then create ~/.kiro/generators/default.toml:

allowedTools = ["read", "knowledge"]

Both approaches can be mixed. Inline config takes precedence.

Agents can be declared globally or locally:

Use kg validate to see the merged configuration.