For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Hivel settings (hivel:)

Jira settings (jira:)

GitHub settings (github:)

GitLab settings (gitlab:)

Bitbucket settings (bitbucket:)

Azure DevOps settings (azure:)

Full config example

Last updated