> 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/hivel-settings-hivel.md).

# Hivel settings (hivel: )

The hivel: block is required in every config.yml. It holds the credential hivel-agent uses to authenticate to Hivel's platform, plus a few agent-wide behavior toggles that control what, if anything, gets sent back to Hivel beyond your metadata.

| **Key**              | **Required**    | **Default** | **Description**                                                                                                                                           |
| -------------------- | --------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| api\_token           | Yes (sync/send) | -           | From Hivel dashboard → Settings → API Tokens                                                                                                              |
| send\_agent\_config  | No              | false       | Upload a sanitized copy of this config on every run (credentials redacted). See Sending config to Hivel.                                                  |
| stream\_logs         | No              | false       | Stream agent logs to Hivel in real time for live debugging.                                                                                               |
| no\_override\_config | No              | false       | Skip GET /api/agent/scm-config on startup. When true, only values in config.yml are used - no server-side overrides applied. Applies to GitHub sync only. |

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

{% column %}

{% endcolumn %}

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