Configuration

Agent Smith is configured through a single YAML file and optional skill/tool definitions.

Prefer the UI? Edit config in the browser

You don't have to hand-edit YAML. The dashboard's Configuration studio is a picked-not-typed catalog — create and wire projects, agents, trackers, repos and connections in the UI, with referential integrity and an audit trail, then export back to agentsmith.yml. The studio and the file read and write the same store, so they never disagree. This page documents that on-disk file.

Configuration Files

File	Location	Purpose
agentsmith.yml	Project root	Main configuration: projects, AI provider, secrets, pipelines
Skill YAMLs	config/skills/<category>/	Role definitions for multi-agent discussions
nuclei.yaml	config/	Nuclei scanner settings for API security scans
spectral.yaml	config/	Spectral OpenAPI linter ruleset

Pages

• :material-file-cog: agentsmith.yml Reference -- Full configuration reference with annotated examples
• :material-account-group: Skills Reference -- Skill YAML format for multi-role agent discussions
• :material-wrench: Tool Configuration -- Nuclei and Spectral config for the api-scan pipeline
• :material-webhook: Webhooks -- GitHub webhook setup, signature verification, PR comment commands
• :material-shield-check: Security Scan Config -- DAST (ZAP), auto-fix, and trend analysis configuration

File Discovery

Agent Smith searches for configuration in this order:

1. --config CLI flag (explicit path)
2. agentsmith.yml in current directory
3. agentsmith.yaml in current directory
4. config/agentsmith.yml

Tip

Run agent-smith init-project to generate a starter agentsmith.yml with sensible defaults for your repository.