Reference

Configuration

Use .github/tigent.yml to tell tigent how to classify, which model to use, and which labels must never be applied automatically.

File Location

Tigent reads an optional repo config from:

.github/tigent.yml

Default Behavior

if the file is missing, tigent still runs. it reads label names and descriptions directly from github and uses the default model.

The Three Config Surfaces

hard enforcement

Blocklist

top-level labels that tigent must never add on its own.

classification guidance

Prompt

repo-specific instructions for how to map issue and pr content to labels.

runtime selection

Model

override the default model when you need a different classification backend.

Blocklist

Use blocklist for workflow labels such as backports, release markers, or anything maintainers want to apply manually.

tigent.yml

blocklist:
  - backport
  - major
  - minor
  - pull request welcome
  - good first issue

Important

blocklist is enforced after model output in code. it is not prompt text, and memory does not bypass it.

Prompt

Use the prompt to shape classification, not to hold hard restrictions. it should explain label meaning, routing rules, and repo-specific conventions.

tigent.yml

prompt: |
  you are the labeling agent for this repo.
  when in doubt, add support.
  provider-specific issues get ai/provider and the matching provider label.
  setup questions usually map to support.

Model

Tigent defaults to ai sdk 6 with anthropic/claude-sonnet-4.6.

When you use the default model, tigent prefers bedrock through ai gateway and falls back to anthropic if bedrock is unavailable.

model: anthropic/claude-sonnet-4.6

Full Example

tigent.yml

model: anthropic/claude-sonnet-4.6

blocklist:
  - backport
  - major
  - minor

prompt: |
  you are the labeling agent for this repo.
  when in doubt, add support.
  provider-specific issues get ai/provider and the matching provider label.
  setup questions usually map to support.

Quickstart

Labels