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

Full config example

Below is a single config.yml combining Jira, GitHub, Azure DevOps, and Claude OTel in one file, to show how the top-level blocks sit next to each other in practice.

hivel:
  api_token: ${HIVEL_API_TOKEN}
  send_agent_config: true   # optional - helps Hivel support debug issues
 
jira:
  - instance_slug: jira
    url: https://your-org.atlassian.net
    email: ${JIRA_EMAIL}
    token: ${JIRA_TOKEN}
    earliest_issue_date: "2025-01-01"
 
    include_projects:
      - ENG
      - INFRA
    exclude_projects:
      - SANDBOX
 
    required_hivel_types:
      - STORY_POINTS
      - SPRINT
      - PRODUCT
      - ALLOCATION
      - EPIC
 
    extra_fields:
      - customfield_10016 - STORY_POINTS
      - customfield_10020 - SPRINT
      - customfield_10042 - PRODUCT
      - customfield_10044 - ALLOCATION
      - customfield_10014 - EPIC
 
    download_sprints: true
    issue_batch_size: 100
    issue_download_concurrent_threads: 10
 
github:
  - instance_slug: github-main
    token: ${GITHUB_TOKEN}
    earliest_data_date: "2025-01-01"
    include_orgs:
      - your-github-org
    exclude_pr_source_branches:
      - "dependabot/*"
      - "renovate/*"
    concurrent_threads: 10
 
azure:
  - instance_slug: azure-main
    token: ${AZURE_TOKEN}
    organization: your-org
    earliest_data_date: "2025-01-01"
    exclude_pr_source_branches:
      - "dependabot/*"
    concurrent_threads: 5
    
claudeotel:
- instance_slug: acme-claude
  base_url: https://otel-collector.hivel.ai/api
  api_key: dummy-value
  org_id: "1132"

Last updated