Awesome

Neorg Telescope

This repo hosts a 3rd party module for Neorg to integrate with telescope.nvim

🌟 Showcase

Fuzzy Searching Any Linkable

Simply jump to any important element in the workspace. This includes headings, drawers, markers. The command for this is Telescope neorg find_linkable

Automatic Link Insertion

Simply press a key (<C-l> in insert mode by default) and select what you want to link to.

insert_link only works for elements in the current workspace.

Automatic File Link Insertion

You can use Telescope neorg insert_file_link to insert a link to a neorg file. Notice that this only works for files in the current workspace. Note: If no file is selected a link to a file with the name of the prompt value will be inserted. This file will be created if you use the link with <img alt="neorg's hop" src="https://github.com/nvim-neorg/neorg/wiki/Esupports-Hop"/>

Fuzzy Searching Headings

With Telescope neorg search_headings you can search through all the headings in the current file.

Search File and Heading Backlinks

• Telescope neorg find_backlinks - find every line in your workspace that links^* to the current file
• Telescope neorg find_header_backlinks - same but with links to the current file and heading

These are limited to workspace relative links (ie. {:$/worspace/relative/path:}) for the sake of simplicity. Both exact ({:$/path:** lvl 2 heading}) and fuzzy ({:$/path:# heading}) links are found.

Gtd Pickers

Those pickers are all broken since gtd was removed in core

Find Project Tasks

Use Telescope neorg find_project_tasks to pick a project and then the tasks inside it. You can then jump to those tasks. If you select and empty project (colored gray) then you'll jump to the project.

<video alt="find_project_tasks" src="https://user-images.githubusercontent.com/81827001/158395250-b4de0f8b-c693-4f55-ae6e-c66f6055f741.mov"></video>

Find Context Tasks

With Telescope neorg find_context_tasks you pick a context and then tasks. <video alt="find_context_tasks" src="https://user-images.githubusercontent.com/81827001/158401579-ef8e7d9a-2d84-4e05-8f7d-d1f3815a67ee.mov"></video>

Find AOF Tasks

You can use Telescope neorg find_aof_tasks to pick an aof and then search through the tasks of it. <video alt="find_aof_tasks" src="https://user-images.githubusercontent.com/81827001/158401242-5d61c18a-ab77-4942-ad31-0e6dede410df.mov"></video>

Find AOF Project Tasks

When you use Telescope neorg find_aof_project_tasks you can pick an area of focus, then a project inside it and last but not least you can search for tasks inside the project. <video alt="find_aof_project_tasks" src="https://user-images.githubusercontent.com/81827001/158401841-9ca3a311-bac1-4733-9a6e-6125003d8a38.mov"></video>

Until the new GTD infrastructure arrives, you could collect all your todo items with a regex, for example:

-- Make sure you have ripgrep installed.
-- Add the following function to your `~/.config/nvim/init.lua`:
do
    local _, neorg = pcall(require, "neorg.core")
    local dirman = neorg.modules.get_module("core.dirman")
    local function get_todos(dir, states)
        local current_workspace = dirman.get_current_workspace()
        local dir = current_workspace[2]
        require('telescope.builtin').live_grep{ cwd = dir }
        vim.fn.feedkeys('^ *([*]+|[-]+) +[(]' .. states .. '[)]')
    end

    -- This can be bound to a key
    vim.keymap.set('n', '<c-t>', function() get_todos('~/notes', '[^x_]') end)
end

🔧 Installation

First, make sure to pull this plugin down. This plugin does not run any code in of itself. It requires Neorg to load it first:

You can install it through your favorite plugin manager:

• <details> <summary><a href="https://github.com/wbthomason/packer.nvim">packer.nvim</a></summary>

  use {
      "nvim-neorg/neorg",
      config = function()
          require('neorg').setup {
              load = {
                  ["core.defaults"] = {},
                  ...
                  ["core.integrations.telescope"] = {}
              },
          }
      end,
      requires = { "nvim-lua/plenary.nvim", "nvim-neorg/neorg-telescope" },
  }
  

• <details> <summary><a href="https://github.com/junegunn/vim-plug">vim-plug</a></summary>

  Plug 'nvim-neorg/neorg' | Plug 'nvim-lua/plenary.nvim' | Plug 'nvim-neorg/neorg-telescope'
  

  You can then put this initial configuration in your init.vim file:

  lua << EOF
  require('neorg').setup {
    load = {
        ["core.defaults"] = {},
        ...
        ["core.integrations.telescope"] = {}
    },
  }
  EOF
  

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

  require("lazy").setup({
      {
          "nvim-neorg/neorg",
          opts = {
              load = {
                  ["core.defaults"] = {},
                  ...
                  ["core.integrations.telescope"] = {},
              },
          },
          dependencies = { { "nvim-lua/plenary.nvim" }, { "nvim-neorg/neorg-telescope" } },
      }
  })
  

  </details>

Configuration

This module accepts the following configuration with the shown defaults:

{
    ...
    ["core.integrations.telescope"] = {
        config = {
            insert_file_link = {
                -- Whether to show the title preview in telescope. Affects performance with a large
                -- number of files.
                show_title_preview = true,
            },
        }
    }
}

Usage

You can define keybindings like this:

vim.keymap.set("n", "<lhs>", "<Plug>(neorg.telescope.search_headings)")

List of all available plug mappings:

• neorg.telescope.backlinks.file_backlinks
• neorg.telescope.backlinks.header_backlinks
• neorg.telescope.find_linkable
• neorg.telescope.find_norg_files
• neorg.telescope.insert_file_link
• neorg.telescope.insert_link
• neorg.telescope.search_headings
• neorg.telescope.switch_workspace

Support Welcome

If it's not clear by the code already, I'm a solid noob at telescope related things :)

If you have any awesome ideas or any code you want to contribute then go ahead! Any sort of help is appreciated :heart:

Some Ideas Right Off The Top Of My Head

• Fuzzy searching content in paragraphs only
• Fuzzy searching content in the current heading

GIFs

Insert Link