Sort items by frecency (frequency + recency)

[lalvarezt]

Sorts fzf results based on your selection history, prioritizing items you use frequently and recently (frequency + recency = "frecency").

Note: Author has stated (#777, #1213) that they're not interested in adding this functionality, so I thought I'll give it a try.

How it works:

• Tracks every selection: increments frequency counter and updates timestamp
• Calculates score using time-weighted frequency: score = frequency × time_weight
  • Recent (< 1h): 4.0x weight
  • Today (< 1d): 2.0x weight
  • This week (< 1w): 0.5x weight
  • Older: 0.25x weight
• Persists data in ~/.cache/fzf/frecency.gob
• Uses logarithmic scaling to handle wide score range (0.25 to 1M+)

Usage:

fzf --frecency              # Enable frecency sorting
fzf --frecency-file=PATH    # Custom database location
fzf --frecency-debug        # Show database contents

Inspired by: zoxide's frecency algorithm for directory jumping.

You can check it here (frecency branch)
https://github.com/lalvarezt/fzf/tree/frecency

---

Updates

2025-10-10

Added new actions to manage the frecency database

• frecency-entry-buff
• frecency-entry-nerf
• frecency-entry-remove

It can be used like so:

fzf --frecency --bind alt-r:frecency-entry-nerf --bind alt-t:frecency-entry-buff