Configuration

Configure Carnet with carnet.config.json.

Configuration File

Create carnet.config.json in your carnet directory (alongside agents/, skills/, and toolsets/):

{
  "app": {
    "globalInitialSkills": [],
    "globalSkills": []
  },
  "variables": {},
  "envPrefix": ["CARNET_", "PUBLIC_"],
  "include": [],
  "exclude": []
}

Options

output

Directory where manifest is written.

• Default: same directory as config file or ./carnet
• Type: string

app

Global agent configuration.

• globalInitialSkills - Skills auto-loaded for all agents
• globalSkills - Skills available to all agents

variables

Template variables for content substitution.

• Type: Record<string, string>
• See Variable Injection for details

envPrefixes

Environment variable prefixes allowed for substitution.

• Default: ["CARNET_", "PUBLIC_"]
• Type: string[]
• See Variable Injection for details

include

Glob patterns to include.

• Type: string[]
• If specified, only matching files are discovered

exclude

Glob patterns to exclude.

• Type: string[]
• Examples: **/draft/**, **/*.example.md

Content Structure

Before building, you need to organize your agents, skills, toolsets, and tools in the content directory. See these guides to understand how to structure your content:

• Agents - AI agents with prompts and skills
• Skills - Capabilities that group tools
• Toolsets - Collections of related tools
• Tools - Individual capabilities or functions

After you've structured your content, the carnet build command compiles everything into a production-ready manifest. See the Manifest Schema for details on the compiled output.

Learn More

• Config File - Detailed configuration options
• Variable Injection - Template variables and environment substitution
• Quick Start - Get started quickly
• API Reference - Complete API documentation