Skip to main content

clawdesk-agent-config

The agent-config crate provides a declarative configuration system for defining agents through TOML or YAML files.

What It Does (Plain English)​

Instead of creating agents only through the UI, this crate lets you define agents in configuration files. This is useful for teams who want to share agent definitions, version control them in Git, or automate agent setup across multiple machines.

Key Features​

  • File-based agent definitions — Define agents in TOML/YAML files
  • Validation — Checks that configurations are correct before loading
  • Inheritance — Agents can inherit settings from a base configuration
  • Templates — Predefined agent templates for common use cases
  • Auto-load — Automatically discover and load agent configs from a directory

Example​

[agent]
name = "Code Reviewer"
description = "Reviews code for quality and security"
model = "claude-sonnet-4-20250514"
temperature = 0.3

[agent.system_prompt]
content = """
You are an expert code reviewer. Check for:
1. Bugs and logical errors
2. Security vulnerabilities
3. Performance issues
4. Code style and readability
"""

[agent.skills]
enabled = ["code_executor", "file_reader"]

[agent.limits]
max_tokens = 8192
rate_limit = 60

Architecture Role​

LayerPosition
ConfigurationDeclarative agent definition

Dependencies​

  • clawdesk-types — Agent type definitions
  • clawdesk-agents — Agent registration