Reference
Configuration
Complete reference for sherpa.json — paths, vocabulary, dispatch, governance, and plugins.
The central configuration file for a Sherpa project. Lives at sherpa.json in the project root, or .sherpa/config.json as a fallback.
Created by sherpa init. Supports ${ENV_VAR} interpolation for environment-specific values.
Schema
Prop
Type
admin
Prop
Type
theme
Prop
Type
paths
Prop
Type
vocabulary
Prop
Type
entities
Prop
Type
agents
Prop
Type
mcp
Prop
Type
knowledge
Prop
Type
ollama
Prop
Type
api
Prop
Type
governance
approval
Prop
Type
Example
{
"$schema": "https://sherpa.solar/schema.json",
"admin": {
"projectName": "My Project",
"projectDescription": "What this project does"
},
"paths": {
"initiatives": "docs/initiatives",
"agentRoles": "docs/agents/roles",
"rules": ".claude/rules",
"skills": ".claude/skills"
},
"governance": {
"approval": {
"agents": "never",
"requireAuthority": true
}
}
}See Concepts: Conventions & Config for how configuration fits into the broader system.