Gitty brings a modern, interactive, and beautiful GitHub and Git workflow to Neovim. It provides fuzzy pickers, previews, and side buffers for PRs, issues, branches, workflows, and more — all with color, async loading, and keyboard-driven UX.
2025-06-08.11-33-09.mp4
- Fuzzy pickers for GitHub Pull Requests, Issues, Branches, Commits, and Workflows.
- Rich previews: Markdown rendered with color, commit diffs, PR/issue details, and more.
- Create PRs and Issues in a side buffer with templates and AI-assisted descriptions.
- View and review PR comments, issue comments, and workflow logs in split/floating windows.
- Inline mini diff: Compare current buffer or selection with any commit, accept/reject hunks.
- Compare commits: Diffview, inline, or file-at-commit with 3-pane layout.
- Open on GitHub: Open PRs, issues, commits, and branches in your browser.
- Async loading with spinners for a smooth experience.
- Keymaps for quick access to all features.
With lazy.nvim
Local/dev:
{
dir = "/path/to/gitty",
name = "gitty",
dependencies = {
"nvim-lua/plenary.nvim",
"ibhagwan/fzf-lua",
},
config = function()
require("gitty").setup()
end,
dev = true,
},Remote:
{
"stuckinsnow/gitty",
dependencies = {
"nvim-lua/plenary.nvim",
"ibhagwan/fzf-lua",
},
config = function()
require("gitty").setup()
end,
},For AI assistance to work, you will need to create a new prompt in codecompanion, you can find that at the bottom of this README.
Gitty can be configured with various options:
require("gitty").setup({
spinner_enabled = true, -- Enable loading spinners
preview_width = 0.6, -- Width of preview windows (0.0-1.0)
preview_height = 0.4, -- Height of preview windows (0.0-1.0)
split_diff_treesitter_left = true, -- Enable syntax highlighting in left split diff window (current version)
split_diff_treesitter_right = false, -- Enable syntax highlighting in right split diff window (commit version)
})spinner_enabled(boolean, default:true): Show loading spinners during async operationspreview_width(number, default:0.6): Width ratio for preview windows (0.0 to 1.0)preview_height(number, default:0.4): Height ratio for preview windows (0.0 to 1.0)split_diff_treesitter_left(boolean, default:true): Enable tree-sitter syntax highlighting in the left split diff window (current version). When disabled, shows plain text for better performance and focus on differences.split_diff_treesitter_right(boolean, default:false): Enable tree-sitter syntax highlighting in the right split diff window (commit version). When disabled, shows plain text for better performance and focus on differences.
- fzf-lua
- plenary.nvim
- GitHub CLI (
gh) - fzf
- git
- bat (for colored previews)
- glow (for markdown rendering)
- delta (for diffs)
- mini.diff (for inline diff)
| Keymap | Mode | Action |
|---|---|---|
<leader>g2 |
n | Git Compare (commits, branches, etc.) |
<leader>g3 |
n | Mini Diff (inline diff with commit) |
<leader>g3 |
v | Mini Diff (diff selection with commit) |
In PR/Issue/Commit/Branch pickers:
<CR>: Default action (diff, open, etc.)<C-v>: Open details in right buffer (and show comments/reviews if available)<C-e>: Open details in a new buffer<C-d>: Diffview for PRs<C-x>: Open on GitHub in browser<C-p>: Copy PR commands to clipboard
In PR/Issue creation buffers:
<CR>: Submit PR/Issue<leader>q: Cancel creation<C-s>(insert): Submit PR/Issue
In mini diff:
ga: Accept current hunk/selectiongr: Reject current hunk/selectiongq: Close mini diff
In comparison pickers:
<CR>: Open diffview / minidiff comparisons<C-e>: Show diff in side buffer<C-v>: View file at specific commit (3-pane layout)
File History picker:
<CR>: Copy commit hash to clipboard<C-v>: View file at that commit
You can also add these to your configuration:
vim.keymap.set("n", "<leader>g1n", "<cmd>FzfGithubNotifications<CR>", { desc = "GitHub Notifications" })
vim.keymap.set("n", "<leader>g1p", "<cmd>FzfGithubPrs<CR>", { desc = "GitHub PRs" })
vim.keymap.set("n", "<leader>g1w", "<cmd>FzfGithubWorkflows<CR>", { desc = "Github Workflows" })
vim.keymap.set("n", "<leader>g1i", "<cmd>FzfGithubIssues<CR>", { desc = "GitHub Issues" })
vim.keymap.set("n", "<leader>g1c", "<cmd>FzfCreateIssue<CR>", { desc = "Create GitHub Issue" })
vim.keymap.set("n", "<leader>g1C", "<cmd>FzfCreatePr<CR>", { desc = "Create GitHub PR" })
vim.keymap.set("n", "<leader>g1B", "<cmd>FzfGithubBranches<CR>", { desc = "List Branch Information" })
| Command | Description |
|---|---|
:FzfGithubPrs |
List and preview GitHub Pull Requests |
:FzfGithubNotifications |
List Github Notifications |
:FzfGithubIssues |
List and preview GitHub Issues |
:FzfGithubBranches |
List and preview GitHub Branches |
:FzfGithubWorkflows |
List and preview GitHub Workflows & runs |
:FzfCreatePr |
Create a new Pull Request |
:FzfCreateIssue |
Create a new Issue |
:GittySetup |
(Re)initialize gitty |
:FzfGithubPrs— Fuzzy pick PRs, preview details, diff, open in browser, copy commands, or open reviews.<C-v>on a PR — Open PR details in a side buffer and show reviews.<C-d>— Diffview for PR branch/files.<C-p>— Copy useful PR commands to clipboard.
:FzfGithubIssues— Fuzzy pick issues, preview details, open in browser, or open comments.<C-v>— Open issue details in a side buffer and show comments.
:FzfGithubBranches— List branches, preview latest commit, open on GitHub, or show commits.- Selecting a branch — Show recent commits, preview details, open commit on GitHub, or open commit message in buffer.
:FzfGithubWorkflows— List workflows, select to view runs, preview run details, open logs in split/floating window.
:FzfCreatePr— Guided PR creation in a side buffer, with commit summary and AI description (if available).:FzfCreateIssue— Guided issue creation in a side buffer with template.
<leader>g2— Compare commits/branches: Diffview, inline, or file-at-commit.<leader>g3— Mini diff: Inline diff of current buffer with any commit.- Visual
<leader>g3— Mini diff: Inline diff of selection with any commit.
- All picker actions are customizable via fzf-lua.
- Utility functions for opening buffers, rendering markdown, and more.
- Async helpers for smooth UX.
Gitty provides a reusable utility for copying filenames to clipboard with smart path shortening. This is useful for adding context to AI prompts or documentation.
For FZF buffer pickers (extracts buffer numbers):
require("fzf-lua").buffers({
actions = {
["ctrl-y"] = {
fn = function(selection)
require("gitty.utilities.file-utils").copy_buffer_filenames_to_clipboard(selection)
end,
},
},
})For regular file pickers (direct file paths):
require("fzf-lua").files({
actions = {
["ctrl-y"] = {
fn = function(selection)
require("gitty.utilities.file-utils").copy_filenames_to_clipboard(selection)
end,
},
},
})Customization options:
-- Custom header, prefix, and exclude current buffer
require("gitty.utilities.file-utils").copy_filenames_to_clipboard(selection, {
header = "Context: ",
prefix = "* ",
include_current = false
})Output format:
Context:
- providers/github-compare/picker-utils.lua
- utilities/file-utils.lua
- init.lua
Path shortening shows the last 3 directory levels for better readability while maintaining context.
You will need to set up the following highlights in your Neovim configuration to ensure gitty looks great:
- MiniDiffSign: All diff signs in the buffer.
- MiniDiffSignChange: Changed lines line numbers.
- MiniDiffSignAdd: Added lines line numbers.
- MiniDiffSignDelete: Deleted lines line numbers.
- MiniDiffOverAdd: Highlights added lines.
- MiniDiffOverChange: Highlights changed lines.
- MiniDiffOverDelete: Highlights deleted lines.
- MiniDiffOverContext: Highlights context lines in diffs.
- MiniDiffOverContextBuf: Highlights context buffer for added lines.
- GittySplitLeft: Highlights for the left split window.
- GittySplitRight: Highlights for the right split window.
- GittySplitLeftTitle: Highlights for the left split title.
- GittySplitRightTitle: Highlights for the right split title. ["PR Description"] = {
strategy = "inline",
description = "Generate a professional PR description from recent commits",
opts = {
short_name = "pr",
},
prompts = {
{
role = "system",
content = "You are a senior developer with years of experience. Create professional, concise pull request descriptions that clearly explain what the PR does, and key changes made, list what an experienced developer would mention but do not try impress anyone. The point is to convey information. Format responses as markdown.",
},
{
role = "user",
content = function()
-- Get current branch
local current_branch = vim.fn.system("git rev-parse --abbrev-ref HEAD"):gsub("%s+", "")
-- Get recent commits with full details
local commit_details = vim.fn.system("git log --oneline -n 10 --no-merges"):gsub("\r", "")
-- Get diff summary
local diff_summary = vim.fn.system("git diff --stat HEAD~5..HEAD"):gsub("\r", "")
-- Get list of changed files
local changed_files = vim.fn.system("git diff --name-only HEAD~5..HEAD"):gsub("\r", "")
return string.format(
[[
Please create a professional PR description based on the following information:
**Current Branch:** %s
**Recent Commits:**
%s
**Files Changed:**
%s
**Diff Summary:**
%s
Please generate a well-structured PR description that includes:
- A brief summary of what this PR does
- Key changes made
- Any notable implementation details
- Keep it concise but informative
Format the response as markdown.
]],
current_branch,
commit_details,
changed_files,
diff_summary
)
end,
},
},
},