📜 gist.nvim

A plugin that allows you to create a Gist (and more) from the current file

gist.nvim is a Neovim plugin that allows you to create gists on GitHub, GitLab, or Termbin from the current file. The plugin uses the respective command-line tools (gh for GitHub, glab for GitLab, or direct HTTP for Termbin and 0x0) to create the gist and provides a simple interface for specifying the gist's description and privacy settings.

Installation

To use gist.nvim, you need to have Neovim installed on your system.

Depending on the platform you want to use:

• GitHub: Install the gh command-line tool and configure it with your GitHub account.
• GitLab: Install the glab command-line tool and configure it with your GitLab account.
• Termbin: No additional tools required, as it uses direct HTTP requests.
• SourceHut: Install the hut command-line tool and configure it with your SourceHut account.
• 0x0.st: No additional tools required, as it uses direct HTTP requests (curl).
• PasteCN: No additional tools required, as it uses direct HTTP requests (curl).

Once you have Neovim and gh installed, you can install gist.nvim using your favorite plugin manager.

Using lazy.nvim:

return {
  {
    "Rawnly/gist.nvim",
    cmd = { "GistCreate", "GistCreateFromFile", "GistsList" },
    config = true
  }
}

Using packer.nvim:

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

Usage

To create a gist from the current file, use the :GistCreateFromFile command in Neovim. The plugin will prompt you for a description and whether the gist should be private or public (depending on the platform).

  :GistCreate [description=...] [public=true] [filename=...]

• :GistCreate will create the gist from the current selection or, if no range is given, from the full buffer contents — including unnamed buffers
• :GistCreateFromFile will create the gist from the current file on disk

Both commands accept the same key=value options, which can be combined freely:

Option	Description
description=	Description for the gist. If omitted, you will be prompted (when prompts are enabled).
public=	true or false. Overrides the configured privacy default and skips the privacy prompt.
filename=	Filename used for the gist. Defaults to the current buffer's filename, falling back to default_filename (untitled by default) for unnamed buffers.

Values containing spaces can be wrapped in single or double quotes (e.g. description="quick note").

Examples:

  :GistCreate filename=note.md
  :GistCreate description=todo public=false
  :GistCreate description="quick note" public=true filename=note.md
  :GistCreate description='release notes for v1.2.0' filename=CHANGELOG.md

After you enter the description and privacy settings, the plugin will ask for confirmation and create the gist using the configured platform's tool, then copy the gist's URL to the given clipboard registry.

You can also list your gists and edit their files on the fly (GitHub only).

    :GistsList

• :GistsList lists your gists a page at a time (select … load more for the next page) and after you select one it will:
  • Open the gist in a new tab, one buffer per file (list.mappings.next_file / prev_file cycle through them)
  • Saving a buffer with :w pushes the file back to the gist using gh gist edit
  • With read_only = true the buffers are not modifiable and nothing is pushed

Configuration

gist.nvim provides configuration options via the setup function:

    require("gist").setup({
        platform = "github", -- Default platform: "github", "gitlab", "termbin", or "sourcehut"
        clipboard = "+", -- The registry to use for copying the gist URL
        default_filename = "untitled", -- Filename used when the current buffer has no name
        prompts = {
            create = {
                private = false,      -- Prompt for private/public when creating a gist
                description = false,  -- Prompt for description when creating a gist
                confirmation = false, -- Prompt for confirmation when creating a gist
            },
        },
        platforms = {
            github = {
                private = false, -- All GitHub gists will be public by default
                cmd = "gh",     -- Command for GitHub CLI
                list = {
                    limit = nil,       -- Gists fetched per page, max 100 (default: nil, 30). More pages load on demand
                    read_only = false, -- Opens gists in read-only buffers
                },
            },
            gitlab = {
                cmd = "glab",  -- Command for GitLab CLI
                private = true, -- Create personal snippets by default
            },
            termbin = {
                url = "termbin.com", -- URL for Termbin service
                port = 9999,         -- Port for Termbin service
            },
            ["0x0"] = {
                private = false,
            },
            pastecn = {
                private = false,
                url = "https://pastecn.com",
                type = "file",
            },
            sourcehut = {
                cmd = "hut", -- Command for SourceHut CLI
            },
        },
        list = {
            use_multiplexer = true, -- Use terminal multiplexer (tmux/zellij) if detected for editing gists
            -- If there are multiple files in a gist you can scroll them,
            -- with vim-like bindings n/p next previous
            mappings = {
                next_file = "<C-n>",
                prev_file = "<C-p>"
            }
        }
    })

For GitHub, the cmd defaults to gh. You may want to override this with a custom wrapper, e.g., for 1Password users: op plugin run -- gh.

For GitLab, cmd defaults to glab.

For PasteCN, Termbin and 0x0, no command is needed as it uses direct HTTP.

For SourceHut, cmd defaults to hut.

License

gist.nvim is released under MIT License. See LICENSE for details.

Contributing

If you find a bug or would like to contribute to gist.nvim, please open an issue or a pull request. All contributions are welcome and appreciated!