Introduction

The codi.toml file controls CODI’s behavior. Reference this page to understand every configurable section—from global agent switches to detailed per-environment settings—and see example snippets.

1. Top-Level Schema

[project]

Defines project identity and default language.

2. Agents Section

[agents]

Globally enable or disable built-in agents.

3. Agent-Specific Settings

Scaffold

[scaffold]

Audit

[audit]
linters            = ["slither", "custom-lint"]

Test

[test]
coverage       = true
parallelism    = 4
custom_patterns= ["**/*_spec.ts"]

Deploy

[deploy]

Tweak behavior of each agent.

4. Plugins & Hooks

[plugins]
paths = ["./my-codi-agent", "./another-plugin"]

Register custom agent plugins. Hooks are defined in each agent’s section.

5. Environment Overrides

[deploy.devnet]
network = "devnet"
retries = 2

[deploy.mainnet]

Override deploy settings per cluster.

Conclusion

Use these examples to configure CODI for your project’s needs. Modify toggles, set thresholds, register plugins, and define environment-specific overrides—all via codi.toml.