Configuration

Frankie supports configuration through multiple sources with the following precedence (lowest to highest):

1. Defaults — Built-in application defaults
2. Configuration file — .frankie.toml in current directory, home directory, or XDG config directory
3. Environment variables — FRANKIE_* variables or legacy GITHUB_TOKEN
4. Command-line arguments — command-line interface (CLI) flags take the highest precedence

Higher precedence sources override lower ones. For example, a CLI flag always takes precedence over an environment variable or configuration file value.

Create a .frankie.toml file in the current directory, home directory, or XDG config directory (typically ~/.config/frankie/frankie.toml):

# For single PR mode
pr_url = "https://github.com/owner/repo/pull/123"

# For repository listing mode
owner = "octocat"
repo = "hello-world"

# Authentication
token = "ghp_example"

# Local persistence (optional)
database_url = "frankie.sqlite"

# Pull request metadata cache time-to-live (TTL) (optional, seconds)
pr_metadata_cache_ttl_seconds = 86400

# Time-travel commit history depth (optional, default 50)
commit_history_limit = 50

# Reply drafting options (optional)
reply_max_length = 500
reply_templates = [
  "Thanks {{ reviewer }}. I will update {{ file }}:{{ line }}.",
  "Good catch, {{ reviewer }}. I'll address this now."
]

# Database migrations (set to true to run migrations and exit)
migrate_db = true

When reply_templates is not configured, Frankie uses its built-in starter reply templates. Library consumers can read the same defaults with frankie::DEFAULT_REPLY_TEMPLATES or take an owned copy with frankie::default_reply_templates().

Frankie searches for configuration files in this order:

1. .frankie.toml in the current working directory
2. .frankie.toml in the home directory
3. frankie.toml in $XDG_CONFIG_HOME/frankie/ (typically ~/.config/frankie/)

Table: Supported environment variables.

The GITHUB_TOKEN environment variable is supported for backward compatibility. If both FRANKIE_TOKEN and GITHUB_TOKEN are set, FRANKIE_TOKEN takes precedence.

Run frankie --help to see all available options and their descriptions.