darcs + neovim integration, similar to gitsigns

root

DarcsSigns.nvim

DarcsSigns.nvim is a Neovim plugin that brings the power of the Darcs Theory of Patches to your editor. It displays working tree changes in the sign column (via extmarks) and provides seamless hunk navigation and previewing.

Think of it as gitsigns.nvim, but for Darcs!

Git already won... Why Darcs anyway?

In case you don't know about Darcs, here's a quick primer:

If you are coming from Git, you are used to thinking of history as a rigid graph of snapshots. If you want to move a commit, you have to rewrite history, change hashes, and carefully manage a Directed Acyclic Graph (DAG).

Darcs takes a radically different approach based on the Theory of Patches:

A "Bag" of Patches: Darcs views your repository as an unordered set of patches rather than a linear tree.
True Cherry-Picking: Because patches are commutative (A + B = B + A), you can pull specific changes from a friend's repo without needing to pull their entire history or deal with complex rebasing.
Interactive by Design: Darcs is famous for its interactive interface. It asks you exactly what you want to record or pull, giving you granular control over your code. This also makes it easier to learn for beginners (yes it's easier than git), and easier to use.

We still want to use Darcs because it removes the "Git Anxiety" of managing branches and complex histories, letting you focus on simply sharing code.

Requirements

Neovim 0.10+ (uses vim.system and vim.diff)
darcs in $PATH

Install

Use your plugin manager of choice; the plugin entrypoint is require('darcssigns').setup().

Setup

For using default settings just call:

require(&#39;darcssigns&#39;).setup()

Optional settings you may want to customize:

require(&#39;darcssigns&#39;).setup({
  enabled = true,
  sign_style = &#39;minimal&#39;, -- &#39;ascii&#39; | &#39;minimal&#39;
  debounce_ms = 200,
  signs = {
    add    = { text = &#39;+&#39;, hl = &#39;DarcsSignsAdd&#39; },
    change = { text = &#39;~&#39;, hl = &#39;DarcsSignsChange&#39; },
    delete = { text = &#39;_&#39;, hl = &#39;DarcsSignsDelete&#39; },
    untracked = { text = &#39;┆&#39;, hl = &#39;DarcsSignsUntracked&#39; },
  },
  show_deleted_anchor = true,
  wrap_navigation = true,
  backend = {
    mode = &#39;auto&#39;, -- &#39;auto&#39; | &#39;parse_diff&#39; | &#39;pristine_diff&#39;
    look_for_adds = false,
  },
  darcs = {
    ui = {
      default = &#39;terminal&#39;, -- &#39;terminal&#39; | &#39;scratch&#39; | &#39;float&#39;
      overrides = {
        log = &#39;scratch&#39;,
        status = &#39;scratch&#39;,
        whatsnew = &#39;scratch&#39;,
      },
    },
  },
  untracked = { mode = &#39;grey&#39; }, -- &#39;grey&#39; | &#39;ignore&#39;
  preview = { ui = { default = &#39;scratch&#39; } }, -- &#39;scratch&#39; | &#39;float&#39;
})

sign_style = 'minimal' uses ┃/_ bar-style signs.

Suggested mappings (defaults are off):

vim.keymap.set(&#39;n&#39;, &#39;]c&#39;, require(&#39;darcssigns&#39;).next_hunk)
vim.keymap.set(&#39;n&#39;, &#39;[c&#39;, require(&#39;darcssigns&#39;).prev_hunk)
vim.keymap.set(&#39;n&#39;, &#39;<leader>hp&#39;, require(&#39;darcssigns&#39;).preview_hunk)

Commands

:DarcsSigns toggle|enable|disable|refresh|next_hunk|prev_hunk|preview_hunk
:Darcs {args...} runs in the repo root and chooses UI via darcs.ui config (terminal by default).
:D {args...} is an alias for :Darcs.

Argument expansion: - % expands to the current buffer file (repo-relative). - # expands to the alternate buffer file (repo-relative).

:Darcs uses the current buffer to detect the repo; if the current buffer has no path (e.g. [No Name]), it falls back to the current working directory.

:Darcs initialize / :D initialize works outside a repository (runs in the current working directory).

Darcs repo address

https://hub.darcs.net/eiko/darcssigns.nvim

hub.darcs.net :: eiko -> darcssigns.nvim -> files