| github_token | User-authorized GitHub token used to discover account-wide contributions. | yes | — |
| openai_api_key | Optional OpenAI API key. AI mode requires this or anthropic_api_key. | no | — |
| anthropic_api_key | Optional Anthropic API key. Used in AI mode when no OpenAI key is set. | no | — |
| mode | README writer: auto, ai, or rules. Auto uses AI when a key is present. | no | auto |
| output_file | Markdown file to create or update. | no | README.md |
| section_name | Name used in the managed-section HTML comments. | no | readme-auto-update |
| model | Model used in AI mode. Defaults to gpt-5.6-luna for OpenAI and claude-opus-4-8 for Anthropic. | no | — |
| days | Contribution-history window, from 1 to 365 days. | no | 365 |
| max_repositories | Maximum number of named repositories included in the README evidence. | no | 30 |
| include_owned | Include repositories owned by the authenticated user. | no | true |
| include_organizations | Include contributions to repositories owned by the user's organizations. | no | true |
| include_open_source | Include public contributions outside the user's organizations. | no | true |
| include_private | Include private activity when the token permits it. | no | true |
| show_private_names | Allow private repository names and descriptions in generated evidence and output. | no | false |
| include_archived | Include archived repositories. | no | false |
| prompt | Additional style or content instructions for AI mode. | no | — |
| commit | Commit and push README.md when it changes. | no | true |
| commit_message | Commit message for automatic updates. | no | docs: update README with README Auto Update |
| commit_username | Git author name for automatic updates. | no | readme-auto-update[bot] |
| commit_email | Git author email for automatic updates. | no | readme-auto-update-bot@example.invalid |
| dry_run | Generate and print a diff without writing or pushing. | no | false |