> ## Documentation Index
> Fetch the complete documentation index at: https://trunk-4cab4936-mintlify-d9625e44.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

Trunk integrates with GitHub through three separate apps. Install the ones you need for the products you use.

<Card title="Trunk (required)" icon={<svg width="24" height="24" viewBox="0 0 56 56" fill="none" xmlns="http://www.w3.org/2000/svg"><circle cx="28" cy="28" r="28" fill="#222530"/><path d="M20.8574 9.51791C24.5122 8.00664 28.5336 7.61254 32.4121 8.38607C36.2904 9.15963 39.8521 11.0661 42.6475 13.8636C45.4428 16.6612 47.3468 20.2248 48.1172 24.1038C48.8876 27.983 48.4898 32.004 46.9756 35.6576C45.4613 39.311 42.8979 42.4334 39.6094 44.6302C36.3208 46.8271 32.4549 48.0003 28.5 48.0003V43.638C31.5961 43.638 34.623 42.7194 37.1973 40.9994C39.7714 39.2793 41.7781 36.8342 42.9629 33.974C44.1475 31.1137 44.4574 27.9664 43.8535 24.93C43.2495 21.8934 41.7586 19.1037 39.5693 16.9144C37.3801 14.7251 34.5903 13.2342 31.5537 12.6302C28.5174 12.0263 25.37 12.3362 22.5098 13.5208C19.6495 14.7056 17.2045 16.7124 15.4844 19.2865C13.7643 21.8607 12.8457 24.8877 12.8457 27.9837H8.5C8.50322 24.0289 9.6794 20.1641 11.8789 16.8773C14.0785 13.5905 17.2027 11.0292 20.8574 9.51791ZM28.5 19.8792C30.6526 19.8793 32.7172 20.7351 34.2393 22.2572C35.7612 23.7793 36.6162 25.8439 36.6162 27.9964H32.2705C32.2384 27.0184 31.8272 26.0911 31.124 25.4105C30.4208 24.7299 29.4805 24.349 28.502 24.349C27.5233 24.349 26.5832 24.7299 25.8799 25.4105C25.1766 26.0911 24.7655 27.0183 24.7334 27.9964H20.3828C20.3828 25.8438 21.2386 23.7793 22.7607 22.2572C24.2829 20.735 26.3473 19.8792 28.5 19.8792ZM28.5 18.2874C25.9255 18.2896 23.4566 19.313 21.6357 21.1331C19.815 22.9532 18.7903 25.421 18.7871 27.9954H14.4414C14.4457 24.2684 15.9282 20.6954 18.5635 18.0599C21.199 15.4244 24.7728 13.9411 28.5 13.9369V18.2874Z" fill="white"/></svg>} href="setup/integrations/github/trunk-sudo" cta="permissions">
  Core integration for the Merge Queue.
</Card>

<Card title="Trunk Sudo" icon={<svg width="24" height="24" viewBox="0 0 56 56" fill="none" xmlns="http://www.w3.org/2000/svg"><circle cx="28" cy="28" r="28" fill="#222530"/><path d="M20.8574 9.51758C24.5122 8.00631 28.5336 7.61319 32.4121 8.38672C36.2903 9.16028 39.8522 11.0659 42.6475 13.8633C45.4429 16.661 47.3468 20.2253 48.1172 24.1045C48.8875 27.9836 48.4898 32.0038 46.9756 35.6572C45.4614 39.3108 42.898 42.4339 39.6094 44.6309C36.3208 46.8276 32.4548 48 28.5 48V43.6377C31.5961 43.6377 34.623 42.7201 37.1973 41C39.7715 39.2799 41.7781 36.835 42.9629 33.9746C44.1477 31.1142 44.4575 27.9663 43.8535 24.9297C43.2495 21.8933 41.7584 19.1042 39.5693 16.915C37.3801 14.7258 34.5903 13.2349 31.5537 12.6309C28.5172 12.0269 25.3701 12.3368 22.5098 13.5215C19.6494 14.7063 17.2045 16.7128 15.4844 19.2871C13.7644 21.8613 12.8458 24.8875 12.8457 27.9834H8.5C8.50328 24.0286 9.67941 20.1637 11.8789 16.877C14.0785 13.5902 17.2027 11.0288 20.8574 9.51758ZM28.5 19.8799C30.6526 19.88 32.7172 20.7347 34.2393 22.2568C35.7613 23.779 36.6162 25.8435 36.6162 27.9961H32.2705C32.2384 27.018 31.8272 26.0907 31.124 25.4102C30.4208 24.7296 29.4805 24.3487 28.502 24.3486C27.5234 24.3486 26.5831 24.7297 25.8799 25.4102C25.1766 26.0907 24.7655 27.018 24.7334 27.9961H20.3828C20.3828 25.8434 21.2386 23.779 22.7607 22.2568C24.2829 20.7348 26.3474 19.8799 28.5 19.8799ZM28.5 18.2871C25.9255 18.2893 23.4566 19.3127 21.6357 21.1328C19.815 22.9528 18.7904 25.4207 18.7871 27.9951H14.4414C14.4458 24.2681 15.9281 20.695 18.5635 18.0596C21.199 15.4241 24.7728 13.9418 28.5 13.9375V18.2871Z" fill="white"/><path d="M22.5 41.249C22.5 44.9983 19.875 46.873 16.755 47.9603C16.5916 48.0157 16.4142 48.013 16.2525 47.9528C13.125 46.873 10.5 44.9983 10.5 41.249V35.9998C10.5 35.801 10.579 35.6102 10.7197 35.4696C10.8603 35.329 11.0511 35.25 11.25 35.25C12.75 35.25 14.625 34.3501 15.93 33.2103C16.0889 33.0746 16.291 33 16.5 33C16.709 33 16.9111 33.0746 17.07 33.2103C18.3825 34.3576 20.25 35.25 21.75 35.25C21.9489 35.25 22.1397 35.329 22.2803 35.4696C22.421 35.6102 22.5 35.801 22.5 35.9998V41.249Z" fill="white" stroke="white" strokeLinecap="round" strokeLinejoin="round"/></svg>} href="setup/integrations/github/trunk-sudo" cta="permissions">
  Enables the Merge Queue [Direct-to-Queue](/merge-queue/using-the-queue/direct-to-queue) feature.
</Card>

<Card title="Trunk CI" icon={<svg width="24" height="24" viewBox="0 0 56 56" fill="none" xmlns="http://www.w3.org/2000/svg"><circle cx="28" cy="28" r="28" fill="#222530"/><path d="M20.8574 9.51758C24.5122 8.00631 28.5336 7.61319 32.4121 8.38672C36.2903 9.16028 39.8522 11.0659 42.6475 13.8633C45.4429 16.661 47.3468 20.2253 48.1172 24.1045C48.8875 27.9836 48.4898 32.0038 46.9756 35.6572C45.4614 39.3108 42.898 42.4339 39.6094 44.6309C36.3208 46.8276 32.4548 48 28.5 48V43.6377C31.5961 43.6377 34.623 42.7201 37.1973 41C39.7715 39.2799 41.7781 36.835 42.9629 33.9746C44.1477 31.1142 44.4575 27.9663 43.8535 24.9297C43.2495 21.8933 41.7584 19.1042 39.5693 16.915C37.3801 14.7258 34.5903 13.2349 31.5537 12.6309C28.5172 12.0269 25.3701 12.3368 22.5098 13.5215C19.6494 14.7063 17.2045 16.7128 15.4844 19.2871C13.7644 21.8613 12.8458 24.8875 12.8457 27.9834H8.5C8.50328 24.0286 9.67941 20.1637 11.8789 16.877C14.0785 13.5902 17.2027 11.0288 20.8574 9.51758ZM28.5 19.8799C30.6526 19.88 32.7172 20.7347 34.2393 22.2568C35.7613 23.779 36.6162 25.8435 36.6162 27.9961H32.2705C32.2384 27.018 31.8272 26.0907 31.124 25.4102C30.4208 24.7296 29.4805 24.3487 28.502 24.3486C27.5234 24.3486 26.5831 24.7297 25.8799 25.4102C25.1766 26.0907 24.7655 27.018 24.7334 27.9961H20.3828C20.3828 25.8434 21.2386 23.779 22.7607 22.2568C24.2829 20.7348 26.3474 19.8799 28.5 19.8799ZM28.5 18.2871C25.9255 18.2893 23.4566 19.3127 21.6357 21.1328C19.815 22.9528 18.7904 25.4207 18.7871 27.9951H14.4414C14.4458 24.2681 15.9281 20.695 18.5635 18.0596C21.199 15.4241 24.7728 13.9418 28.5 13.9375V18.2871Z" fill="white"/><path d="M24.1666 40H22.5133C22.222 39.9994 21.9384 40.0942 21.7061 40.27C21.4737 40.4458 21.3053 40.6928 21.2266 40.9733L19.66 46.5467C19.6499 46.5813 19.6288 46.6117 19.6 46.6333C19.5711 46.655 19.536 46.6667 19.5 46.6667C19.4639 46.6667 19.4288 46.655 19.4 46.6333C19.3711 46.6117 19.3501 46.5813 19.34 46.5467L15.66 33.4533C15.6499 33.4187 15.6288 33.3883 15.6 33.3667C15.5711 33.345 15.536 33.3333 15.5 33.3333C15.4639 33.3333 15.4288 33.345 15.4 33.3667C15.3711 33.3883 15.3501 33.4187 15.34 33.4533L13.7733 39.0267C13.695 39.3061 13.5276 39.5523 13.2966 39.728C13.0655 39.9037 12.7835 39.9992 12.4933 40H10.8333" stroke="white" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"/></svg>} href="https://github.com/apps/trunk-ci/installations/new" cta="permissions">
  Powers Trunk's CI Intelligence features.
</Card>

#### Permissions

Trunk only uses the permissions relevant to the tools you've enabled. For the underlying GitHub definitions, see the [**GitHub developer docs**](https://docs.github.com/en/rest/authentication/permissions-required-for-github-apps).