>_lisa docs

Sync

Two-way synchronization with Linear and GitHub Issues.

Lisa supports bidirectional sync with external tools. Work in Lisa, see changes in Linear. Update in GitHub, see it in Lisa.

Supported platforms

PlatformSync directionFeatures
LinearBidirectionalIssues, status, priority, labels, projects
GitHubBidirectionalIssues, labels, milestones
SlackInboundAI-powered issue suggestions from conversations

Setting up sync

Linear

  1. Go to Settings > Integrations in your organization
  2. Click Connect Linear
  3. Authorize the OAuth connection
  4. Select which Linear teams to sync

GitHub

  1. Go to Settings > Integrations
  2. Click Connect GitHub
  3. Authorize the OAuth connection
  4. Select repositories to sync

How sync works

Push (Lisa to external)

When you create or update issues in Lisa, changes are pushed to the connected platform:

  • New issues create corresponding issues in Linear/GitHub
  • Status changes map to the platform's workflow states
  • Priority and labels are synchronized

Pull (External to Lisa)

Changes made in Linear or GitHub are pulled back to Lisa:

  • New issues are imported with mapped fields
  • Status updates are reflected in Lisa
  • Comments and label changes are synced

Conflict resolution

When the same issue is modified in both Lisa and an external tool:

  1. Lisa detects the conflict
  2. The sync conflicts view shows both versions
  3. Choose which version to keep or merge manually

Sync status

Check sync status from the dropdown in the sidebar:

  • Synced — All changes are synchronized
  • Pending — Changes waiting to be pushed
  • Conflict — Manual resolution needed
  • Error — Sync failed (check logs)