> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/hybrid-hivel-agent/5.-configuration-reference/github-settings-github.md).

# GitHub settings (github: )

GitHub is configured as a list, so multiple instances (e.g. github.com plus a GitHub Enterprise Server) are supported side by side. The settings below cover connection and auth, which orgs/repos/branches to include or exclude, performance tuning, and privacy controls (redact\_names\_and\_urls, strip\_text\_content).

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Key</strong></td><td><strong>Required</strong></td><td><strong>Default</strong></td><td><strong>Description</strong></td></tr><tr><td>instance_slug</td><td>Yes</td><td>-</td><td>Unique name for this instance (e.g. github-main)</td></tr><tr><td>token</td><td>Yes (self-hosted)</td><td>-</td><td>GitHub Personal Access Token (classic or fine-grained). Omit for Hivel-managed credentials - see Hivel-managed credentials below</td></tr><tr><td>url</td><td>No</td><td>https://api.github.com</td><td>Override for GitHub Enterprise Server</td></tr><tr><td>earliest_data_date</td><td>Yes</td><td>-</td><td>YYYY-MM-DD - pull commits/PRs updated since this date</td></tr><tr><td>include_orgs</td><td>No</td><td>all accessible</td><td>Org slugs to sync</td></tr><tr><td>exclude_orgs</td><td>No</td><td>-</td><td>Org slugs to skip</td></tr><tr><td>include_repos</td><td>No</td><td>all</td><td>Repo names to sync</td></tr><tr><td>exclude_repos</td><td>No</td><td>-</td><td>Repo names to skip</td></tr><tr><td>extra_branches</td><td>No</td><td>-</td><td>Additional branch names to fetch for all repos</td></tr><tr><td>include_branches</td><td>No</td><td>-</td><td>Per-repo branch override map</td></tr><tr><td>concurrent_threads</td><td>No</td><td>10</td><td>Goroutines for concurrent repo fetching</td></tr><tr><td>include_top_level_comments</td><td>No</td><td>false</td><td>Include PR-level (non-inline) comments</td></tr><tr><td>exclude_file_paths</td><td>No</td><td>-</td><td>Glob patterns for PR file paths to drop</td></tr><tr><td>exclude_commit_patterns</td><td>No</td><td>-</td><td>Glob patterns matched against commit messages to skip</td></tr><tr><td>exclude_pr_source_branches</td><td>No</td><td>-</td><td>Glob patterns for PR head branch to skip (e.g. dependabot/*)</td></tr><tr><td>exclude_pr_target_branches</td><td>No</td><td>-</td><td>Glob patterns for PR base branch to skip</td></tr><tr><td>exclude_teams</td><td>No</td><td>-</td><td>Glob patterns for team slugs/names to skip</td></tr><tr><td>use_rest_only</td><td>No</td><td>false</td><td>Force REST-only (for GHE without GraphQL)</td></tr><tr><td>skip_ssl_verification</td><td>No</td><td>false</td><td>Disable TLS verification (self-signed certs on GHE)</td></tr><tr><td>redact_names_and_urls</td><td>No</td><td>false</td><td>Replace names and URLs with redacted-NNNN placeholders</td></tr><tr><td>strip_text_content</td><td>No</td><td>false</td><td>Strip all text (commit messages, PR titles, etc.)</td></tr></tbody></table>

**GitHub API used:** GraphQL (primary) + REST (auth check, rate limits). Public GitHub and GitHub Enterprise Server supported.

**Multi-instance credentials** - use a different ${ENV\_VAR} name per entry in config.yml; define each in .env:

```
# config.yml
github:
  - instance_slug: github-cloud
    token: ${GH_CLOUD_TOKEN}
    # url omitted → api.github.com
 
  - instance_slug: github-server
    token: ${GH_SERVER_TOKEN}
    url: ${GH_SERVER_URL}
    use_rest_only: true
    skip_ssl_verification: true
# .env
GH_CLOUD_TOKEN=ghp_cloud...
GH_SERVER_TOKEN=ghp_server...
GH_SERVER_URL=https://github.mycompany.com
```

{% columns %}
{% column %} <a href="/hybrid-hivel-agent/5.-configuration-reference/jira-settings-jira.md" class="button primary" data-icon="backward">Jira settings</a>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %} <a href="/hybrid-hivel-agent/5.-configuration-reference/gitlab-settings-gitlab.md" class="button primary" data-icon="forward">GitLab settings</a>
{% endcolumn %}
{% endcolumns %}
