Skip to main content
The interactive @ and / menus float the files and commands you pick most into the top slots — no setup, no config.

​
Quick Start

1

Pick a file once with @

Start an interactive session, type @acc and accept src/accounts.py from the popup.
2

Pick it again — it's first in the menu

Next time you type @acc, the file you chose is ranked above the other close matches.

​
How It Works

Each pick is recorded, and the next menu uses a small usage boost (0–20) to reorder matches. Recent picks count more than old ones: The boost is round(count × weight × 4), capped at 20.
  • @ files — the boost is added to the 0–100 fuzzy score before sorting.
  • / commands — matching commands are sorted by boost alone; ties keep their original order.
For @ files, the 20-point cap means usage only reorders close matches. A heavily used weak hit (about 59 + 20) still ranks below an unused “starts with” hit (90).

​
Which Surfaces Use It

Ranking applies wherever you accept an @ file or a / command from a menu.

​
Where History Is Stored

History lives in ~/.praisonai/sessions/projects/<project-id>/frecency.json (under PRAISONAI_HOME if set). Clones and worktrees of the same repo share one history. Delete the file to reset ranking.

​
No Config Needed

There is no on/off switch — an empty history already gives the original fuzzy order.
A missing or corrupt frecency.json is ignored, so completion keeps working. Each kind keeps at most 200 entries; the least recently used are dropped first.

​
Best Practices

Delete frecency.json in the project’s sessions folder to start fresh. The next pick creates a new file.
Clones and worktrees of the same repo share history; unrelated repos never see each other’s picks.
For @ files the 20-point cap keeps much better string matches on top. For / commands, used commands rise above unused ones — type more of the name to narrow the list.
Files and commands are tracked separately, so a busy /help never affects @ file order.

@Mentions

Include files, docs and URLs in your prompt

Slash Commands

Every / command in one menu