> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mains.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

The Jira integration syncs issues from your Jira projects into Mains's entity store. Jira tickets become searchable locally and available as context in AI chat.

## **Authentication**

Jira uses **OAuth** for authentication. Mains will open a browser window to authorize access to your Atlassian account.

## **Setup**

<Steps>
  <Step title="Connect Jira">
    Go to **Settings > Connections** and click **Connect** next to Jira. Authorize Mains through the Atlassian OAuth flow.
  </Step>

  <Step title="Select Projects">
    Choose which Jira projects to sync. Only issues from selected projects will be fetched.
  </Step>

  <Step title="Initial Sync">
    Mains fetches existing issues and then syncs incrementally on subsequent runs.
  </Step>
</Steps>