telescope-frecency.nvim

An implementation of Mozillas Frecency algorithm for telescope.nvim.

Frecency: sorting by "frequency" and "recency"

Frecency is a score given to each unique file loaded into a Neovim buffer. On each load a timestamp is recorded to a database. The score is calculated using the age of each of the timestamps and the amount of times the file has been loaded:

recency_score =
   timestamp_age = 240      => value = 100  -- past 4 hours 
   timestamp_age = 1440     => value = 80   -- past day     
   timestamp_age = 4320     => value = 60   -- past 3 days  
   timestamp_age = 10080    => value = 40   -- past week    
   timestamp_age = 43200    => value = 20   -- past month   
   timestamp_age = 129600   => value = 10   -- past 90 days

score  = frequency * recency_score / number_of_timestamps

WIP

TODO

• Implement sorter based on frecency score
• Check file entries are valid via async job on VimClose

Requirements

• telescope.nvim (required)
• sql.nvim (required)

Timestamps and file records are stored in an SQLite3 database for persistence and speed. This plugin uses sql.nvim to perform the database transactions.

Installation

TODO:

use {
  "sunjon/telescope-frecency",
  config = function()
    require"telescope".load_extension("frecency")
  end
}

Configuration

Function for keymaps

lua require("telescope").extensions.frecency.frecency(opts)

:Telescope frecency