atlas.nvim

[![Neovim](https://img.shields.io/badge/Neovim-0.10+-blue.svg)](https://neovim.io/)
[![Version](https://img.shields.io/github/v/tag/emrearmagan/atlas.nvim.svg)](https://github.com/emrearmagan/atlas.nvim/tags)
[![CI](https://github.com/emrearmagan/atlas.nvim/actions/workflows/ci.yml/badge.svg)](https://github.com/emrearmagan/atlas.nvim/actions/workflows/ci.yml)
[![License](https://img.shields.io/github/license/emrearmagan/atlas.nvim?style=flat-square&color=blue)](LICENSE)
[![Playground](https://img.shields.io/badge/Playground-try_it-blue.svg)](https://playground.atlasnvim.dev)

# atlas.nvim

Review pull requests and manage issues across GitHub, GitLab, Bitbucket and Jira without leaving your editor.

<p>
  <img alt="GitHub" src="https://img.shields.io/badge/GitHub-181717?style=flat-square&logo=github&logoColor=white">
  <img alt="Bitbucket" src="https://img.shields.io/badge/Bitbucket-0052CC?style=flat-square&logo=bitbucket&logoColor=white">
  <img alt="GitLab" src="https://img.shields.io/badge/GitLab-FC6D26?style=flat-square&logo=gitlab&logoColor=white">
  <img alt="Jira" src="https://img.shields.io/badge/Jira-0052CC?style=flat-square&logo=jira&logoColor=white">
</p>

<img alt="github" src="https://github.com/user-attachments/assets/08281971-0c9f-404f-a106-4aede061b770" />

> [!CAUTION]
> **Still in early development, will have breaking changes!**

**Quick links**

- [Configuration](#configuration)
- [Pull requests](#pulls)
  - [GitHub](#github)
  - [GitLab](#gitlab)
  - [Bitbucket](#bitbucket)
- [Issues](#issues)
  - [GitHub](#github-issues)
  - [GitLab](#gitlab-issues)
  - [Jira](#jira)
- [Commands](#commands)

## Installation

<details>
<summary><strong>Using <a href="https://github.com/folke/lazy.nvim">lazy.nvim</a></strong></summary>

```lua
{
  "emrearmagan/atlas.nvim",
  dependencies = {
    "nvim-tree/nvim-web-devicons", -- optional but recommended
    "esmuellert/codediff.nvim", -- optional (PullRequest diff)
    "sindrets/diffview.nvim", -- optional; or "dlyongemallo/diffview-plus.nvim"
  },
  -- See Configuration below
  ---@type AtlasConfig
  opts = {},
}
```

</details>

<details>
<summary><strong>Using <a href="https://neovim.io/doc/user/pack/#vim.pack">vim.pack</a> (Neovim 0.12+)</strong></summary>

```lua
vim.pack.add({
  "https://github.com/emrearmagan/atlas.nvim",
})

-- See Configuration below
require("atlas").setup({})
```

</details>

<details>
<summary><strong>Requirements</strong></summary>

- Neovim: `0.10+`
- `git` and `curl` on `$PATH`
- Jira: Jira Cloud REST API v3 (`*.atlassian.net`) or Jira Server REST API v2
- Bitbucket: Bitbucket Cloud REST API 2.0 (`api.bitbucket.org`)
- GitHub: GitHub CLI (`gh`) authenticated with `gh auth login`
- GitLab: GitLab 17.7+ (`gitlab.com` or self-hosted), Personal Access Token with `api` scope

</details>

> [!tip]
> It's a good idea to run `:checkhealth atlas` to see if everything is set up correctly.

## Review Pull Requests

<img alt="AtlasDiff" src="https://github.com/user-attachment