GitCast.nvim

A comprehensive git dashboard for Neovim that provides an intuitive interface for git operations.

Dashboard

Commit detail

Comparing against tracking branch

Installation

With lazy.nvim

{
  "n1kben/gitcast.nvim",
  config = function()
    require("gitcast").setup()
  end,
  cmd = "GitCast",
  keys = {
    { "<leader>g", "<cmd>GitCast<cr>", desc = "Open GitCast dashboard" },
  },
}

With packer.nvim

use {
  "n1kben/gitcast.nvim",
  config = function()
    require("gitcast").setup()
  end,
}

Usage

Opening the Dashboard

:GitCast

Or use your configured keybinding (e.g., <leader>g)

Keybindings

g? Show help

Configuration

Tracking Branch Configuration

GitCast uses git config to store per-repository tracking branch preferences:

# Set tracking branch for current repository
git config --local gitcast.trackingbranch main

# View current setting
git config --local gitcast.trackingbranch

Or use the dashboard: navigate to "Tracking:" line and press <CR> to select a different branch.

Requirements

• Neovim >= 0.8.0
• Git installed and accessible in PATH
• Terminal with Unicode support (for status icons)
• Delta (for file diff)

Performance Tracking

Enable performance tracking to monitor git operation times:

require("gitcast").setup({
  performance_tracking = true,
})

Performance data is displayed using Neovim's debug output with detailed timing information.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

License

MIT License - see LICENSE file for details.

Credits

Developed by @n1kben as a comprehensive git workflow solution for Neovim.