Get Started

Installation

Install the github app, review the permissions, and start with a narrow scope before trusting the agent broadly.

Hosted Scope

Current Deployment

the current hosted deployment is limited to the vercel and tigent organizations. if you need broader usage, self-hosting or a later hosted expansion is required.

Install The GitHub App

Install tigent on the repositories where you want automatic issue and pr triage.

Install GitHub App

Permissions

issues: write

apply and remove issue labels during triage and correction.

pull_requests: write

apply and remove labels on pull requests.

contents: read

read .github/tigent.yml from the repository.

contents: write

open learning prs that update .github/tigent.yml when maintainers ask tigent to improve.

AI Gateway Auth

tigent can authenticate to ai gateway with either a static api key or a vercel oidc token.

tigent.yml

AI_GATEWAY_API_KEY=your-vercel-ai-gateway-key

# or

VERCEL_OIDC_TOKEN=your-vercel-oidc-token

Choose One Path

if both are present, the api key is used. on vercel deployments, oidc is usually the cleaner default.

Recommended Rollout

1. Start Narrow

install on a single repo first and watch how labels behave.

2. Add Blocklist

protect workflow labels before you rely on automation.

3. Use Feedback

correct decisions early so memory and config evolve with maintainers.

Introduction

Quickstart