> 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.md).

# 5. Configuration Reference

This section documents every key you can set in config.yml, hivel-agent's single configuration file. The file has one top-level block per concern: hivel: for agent-wide settings and your API token, one block per source system you're syncing (jira:, github:, gitlab:, bitbucket:, azure:), and claudeotel: if you're tracking Claude Code usage. Source-system blocks are all lists, so you can configure more than one instance of the same tool.

All values below support ${ENV\_VAR} substitution. Referencing an unset env var causes a startup error - no silent failures.

[Hivel-managed credentials](/hybrid-hivel-agent/5.-configuration-reference/hivel-managed-credentials.md)

[Hivel settings (hivel:)](/hybrid-hivel-agent/5.-configuration-reference/hivel-settings-hivel.md)

[Jira settings (jira:)](/hybrid-hivel-agent/5.-configuration-reference/jira-settings-jira.md)

[GitHub settings (github:)](/hybrid-hivel-agent/5.-configuration-reference/github-settings-github.md)

[GitLab settings (gitlab:)](/hybrid-hivel-agent/5.-configuration-reference/gitlab-settings-gitlab.md)

[Bitbucket settings (bitbucket:)](/hybrid-hivel-agent/5.-configuration-reference/bitbucket-settings-bitbucket.md)

[Azure DevOps settings (azure:)](/hybrid-hivel-agent/5.-configuration-reference/azure-devops-settings-azure.md)

[Full config example](/hybrid-hivel-agent/5.-configuration-reference/full-config-example.md)

{% columns %}
{% column %} <a href="/hybrid-hivel-agent/4.-commands-and-workflow/files-generated-per-run.md" class="button primary" data-icon="backward">Files generated per run</a>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %} <a href="/hybrid-hivel-agent/6.-updating-the-agent-and-credentials.md" class="button primary" data-icon="forward">Updating the Agent and Credentials</a>
{% endcolumn %}
{% endcolumns %}