Skip to content
forgedocs

Forge Configuration (Forge.toml)

Customize the Forge context engine using configuration files. Enable rulesets, ignore files, and manage providers.

Last updated: 16 Aug 2026Reference

The Forge.toml File

Forge operates zero-configuration by default, but complex directories can benefit from tailored parameters defined in a local Forge.toml file in your repository root.

Example Configuration

[project]
name = "forge-web"
version = "1.0.0"

[context]
prune_depth = 2
ignore_patterns = ["dist/", "node_modules/", "tmp/"]

[rulesets]
active = ["promptforge", "responseforge"]
custom_prompts = true

[providers]
active = "anthropic"
byok = true

Customizing Rulesets

You can configure rulesets to enforce constraints on output:

  • Minimal Build Mode (YAGNI): Guides models to follow "You Aren't Gonna Need It" principles, eliminating premature abstractions.
  • Concise Mode: Strips conversational filler, forcing the AI to output high-density code snippets.