Skip to content

Repository Config

Customize DAIV's behavior per repository using a .daiv.yml file in the root of the default branch.

Full example

YAML
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
# Repository settings
default_branch: main
context_file_name: "AGENTS.md"

# Files the agent can see but won't read
omit_content_patterns:
  - "*.min.js"
  - "*.svg"
  - "*.lock"

# Feature toggles
issue_addressing:
  enabled: true

pull_request_assistant:
  enabled: true

slash_commands:
  enabled: true

# Sandbox
sandbox:
  base_image: "python:3.12-bookworm"
  ephemeral: false
  network_enabled: false
  cpus: 2.0
  memory_bytes: 4294967296
  command_policy:
    allow: []
    disallow: []

# Model overrides
models:
  agent:
    model: "openrouter:anthropic/claude-sonnet-4.6"
    fallback_model: "openrouter:openai/gpt-5.3-codex"
    thinking_level: "medium"
  diff_to_metadata:
    model: "openrouter:anthropic/claude-sonnet-4.6"
    fallback_model: "openrouter:openai/gpt-5.3-codex"

Repository settings

Option Type Default Description
default_branch str \| null Repository default Branch DAIV uses to load .daiv.yml and as the base for merge requests.
context_file_name str \| null "AGENTS.md" Name of the AGENTS.md guidance file. Set to null to disable.

Tip

The AGENTS.md file helps DAIV understand your repository's structure, conventions, and constraints. You can generate one using the /init skill — see Slash Commands & Skills.

File access

Control which files DAIV can read.

Option Type Default Description
omit_content_patterns list[str] ["*package-lock.json", "*pnpm-lock.yaml", "*.lock", "*.svg"] Files matching these patterns are visible to the agent but their content is not read. Useful for large generated files.

Patterns follow fnmatch syntax.

Feature toggles

All features are enabled by default. Disable any you don't need:

YAML
1
2
3
4
5
6
7
8
issue_addressing:
  enabled: false

pull_request_assistant:
  enabled: false

slash_commands:
  enabled: false
Section Option Default Description
issue_addressing enabled true Issue Addressing
pull_request_assistant enabled true Pull Request Assistant
slash_commands enabled true Slash Commands & Skills

Sandbox

Configure the sandbox for command execution. See Sandbox for a full explanation of what the sandbox does and how the command policy works.

Option Type Default Description
sandbox.base_image str \| null python:3.12-bookworm Docker image. Set to null to disable.
sandbox.ephemeral bool false Ephemeral sessions (no state persistence).
sandbox.network_enabled bool false Allow network access.
sandbox.cpus float \| null null CPU limit.
sandbox.memory_bytes int \| null null Memory limit in bytes.
sandbox.command_policy.allow list[str] [] Command prefixes to explicitly permit.
sandbox.command_policy.disallow list[str] [] Command prefixes to block.

Branch naming and commit conventions

DAIV generates branch names and commit messages automatically. You can define your conventions in AGENTS.md:

Markdown
1
2
3
4
5
6
## Branch naming
Use: pr/<issue-id>-<kebab-summary>

## Commit messages
Use: (<ISSUE-ID>) <type>: <summary>
Where <type> is one of: feat, fix, chore, docs, refactor, test

If no conventions are defined, DAIV defaults to:

  • Branches: <type>/<short-kebab-summary>
  • Commits: Conventional Commits style <type>: <short summary>

Model overrides

Override the default models on a per-repository basis. Useful for using smaller models on simple projects or larger models on complex ones.

Configuration priority (highest to lowest):

  1. Issue labels (daiv-max) — see Issue Addressing
  2. .daiv.yml models section — per-repository overrides
  3. Environment variables — global defaults

Agent

The main DAIV agent used for issue addressing, pull request assistance, and all interactive tasks.

Option Type Default Description
models.agent.model str claude-sonnet-4.6 Primary model.
models.agent.fallback_model str gpt-5.3-codex Fallback if the primary model fails.
models.agent.thinking_level "minimal" \| "low" \| "medium" \| "high" \| null medium Thinking depth. Set to null to disable.

Diff to metadata

Generates pull request titles, descriptions, and commit messages from diffs.

Option Type Default Description
models.diff_to_metadata.model str claude-sonnet-4.6 Primary model.
models.diff_to_metadata.fallback_model str gpt-5.3-codex Fallback if the primary model fails.

Note

The diff to metadata agent reads your AGENTS.md file to follow your branch naming and commit message conventions.