lychee.toml

# Lychee configuration file
# Documentation: https://github.com/lycheeverse/lychee#configuration-file

# Maximum number of retries per link
max_retries = 3

# Maximum number of concurrent requests
max_concurrency = 10

# User agent string
user_agent = "Mozilla/5.0 (compatible; Lychee/0.15; +https://github.com/lycheeverse/lychee)"

# Accept these HTTP status codes as valid
# 403 is added because some sites block automated checkers but work for users
# (e.g. claude.ai, chatgpt.com, help.openai.com, platform.openai.com, nytimes.com,
# studentaffairs.ucdavis.edu)
accept = [200, 201, 202, 203, 204, 206, 301, 302, 303, 307, 308, 403, 429]

# Timeout per request (in seconds)
timeout = 20

# Exclude URLs that CI can't or shouldn't check
exclude = [
  # This site's own Pages URL — only live after a deploy, so it 404s on PRs
  "https://d-morrison.github.io/wai/.*",
  "http://localhost.*",
  "https://localhost.*",
  "http://127.0.0.1.*",
  "https://127.0.0.1.*",
  # quarto.org is a trusted site but may be unreachable from CI runners
  "https://quarto.org/.*",
  # An authenticated MCP API endpoint, quoted as sample `claude mcp list`
  # output in chapters/ai-tools/mcp-server-setup.qmd. It is not a link a
  # reader follows, and 401 is its correct reply to an unauthenticated
  # request, so there is nothing here to fix by editing the URL.
  "https://api.githubcopilot.com/mcp/?.*",
  # Granola MCP endpoint, an authenticated MCP server URL quoted in
  # chapters/ai-tools/mcp-server-setup.qmd. Like the GitHub MCP URL above,
  # it is not a browsable web page and is not expected to return 200 to an
  # unauthenticated GET.
  "https://mcp.granola.ai/mcp.*",
  # OpenRouter authenticated dashboard links and Ollama install script redirect
  "https://openrouter.ai/settings/.*",
  "https://openrouter.ai/credits",
  "https://openrouter.ai/workspaces/.*",
  "https://ollama.com/install.sh",
  # A pull request in a private repository, cited from the vendored
  # ai-config fragment shared/workflow/address-every-comment.md; lychee's
  # GitHub fallback cannot see it with this repo's token, so it always
  # reads as broken. Anchored to that one URL so nothing else is masked.
  "^https://github\\.com/ucdavis/matt\\.contracts/pull/2$",
  # Amp's site answers lychee's HTTP/2 probe with a protocol error
  # ("Server may not support HTTP/2 properly") while loading normally in a
  # browser; linked from chapters/ai-tools/ai-harness-landscape.qmd.
  "^https://ampcode\\.com/?$",
]