Configuration

Complete reference for agentoven.toml — the single configuration file for your kitchen.

AgentOven is configured via agentoven.toml — a single file at the root of your kitchen that defines the workspace settings, agent defaults, MCP tools, and control plane connection.

Full Reference

toml

# Kitchen metadata
[kitchen]
name = "my-kitchen"
description = "Production agent workspace"
version = "0.1.0"

# Control plane connection
[server]
url = "http://localhost:8080"
timeout = 30           # seconds
retries = 3
retry_delay = 1        # seconds

# Authentication
[auth]
method = "jwt"         # jwt | api-key | none
token_path = "~/.agentoven/token"
# api_key = "sk-..."  # alternative to JWT

# Agent defaults (applied to all agents unless overridden)
[defaults.agent]
framework = "langchain"
timeout = 60
max_retries = 2
health_check_interval = 30

# Logging
[logging]
level = "info"         # debug | info | warn | error
format = "json"        # json | text
output = "stdout"      # stdout | file
# file_path = "/var/log/agentoven/kitchen.log"

# MCP Tool configuration
[mcp]
enable = ["web-search", "file-system"]

[[mcp.servers]]
name = "custom-tools"
url = "http://localhost:9090/mcp"
transport = "sse"

# Observability
[observability]
tracing = true
metrics = true
otel_endpoint = "http://localhost:4317"
service_name = "my-kitchen"

# Secrets (references to env vars or vault)
[secrets]
OPENAI_API_KEY = { env = "OPENAI_API_KEY" }
DB_PASSWORD = { vault = "secret/data/db", key = "password" }

[kitchen] — Workspace Metadata

Key	Type	Description
`name`	string	Kitchen name (used in CLI and registry)
`description`	string	Human-readable description
`version`	string	Semantic version of the kitchen config

[server] — Control Plane Connection

Key	Type	Description
`url`	string	Control plane URL (default: http://localhost:8080)
`timeout`	integer	Request timeout in seconds (default: 30)
`retries`	integer	Max retry attempts (default: 3)
`retry_delay`	integer	Delay between retries in seconds (default: 1)

[defaults.agent] — Agent Defaults

Key	Type	Description
`framework`	string	Default agent framework (langchain, crewai, autogen, custom)
`timeout`	integer	Default task timeout in seconds (default: 60)
`max_retries`	integer	Max task retries on failure (default: 2)
`health_check_interval`	integer	Seconds between health checks (default: 30)

CLI Config Management

terminal

# View current config
$ agentoven config show

# Set a value
$ agentoven config set server.url "https://prod.agentoven.dev"
✓ Updated server.url

# Get a value
$ agentoven config get kitchen.name
my-kitchen

# Reset to defaults
$ agentoven config reset
✓ Reset agentoven.toml to defaults