Sort Projects by Usage
An opt-in projects-sidebar display mode that ranks your projects by how much you've used them lately — the number of sessions you have started in the last 30 days — so the ones you are actively working on rise to the top of the group they are already in. It is a display preference — it never renames, moves, archives, hides, or deletes anything, and turning it off restores your manual drag order exactly.
On this page
What it is
An opt-in projects-sidebar display mode that ranks your projects by how much you've used them lately — the number of sessions you have started in the last 30 days — so the ones you are actively working on rise to the top of the group they are already in. It is a display preference — it never renames, moves, archives, hides, or deletes anything, and turning it off restores your manual drag order exactly.
Default: OFF in the base settings, but ON for two of the four onboarding personas, so you may have it without having chosen it. Check the ⋮ menu if your sidebar order looks unfamiliar.
It can never hide a project. Ranking is all it does. See History below — an earlier version also hid dormant projects, and that had to be removed.
What it does — one pass
Rank within the group you already built. Eligible projects are re-ordered by their recent session count (sessions started in the last 30 days), most-active first, and refill the slots they already occupied. That is the whole design: folders, pinned rows and the fixed rows keep their exact positions, and a project can never jump from one folder into another. If you keep "Work" and "Personal" folders, each one re-ranks against itself, and the loose rows rank among themselves. A project with no recent sessions simply sorts last inside its own group — it stays on screen.
Where to find it
Turning it on
Side nav header → the ⋮ menu → Sort by usage. The same menu item turns it back off (Turn off sort by usage, "Go back to your manual drag order"). The side nav's ⋮ menu has no window presets; the "recent" window is the 30 days below unless the setting is changed through the settings API.
Two settings back it:
| Key | Default | Meaning |
|---|---|---|
sidebarSortByUsageEnabled |
false |
Master toggle for the ranking pass. |
sidebarUsageWindowDays |
30 |
The "recent" window in days (no in-app control; fixed at the default). |
How it behaves
What is eligible
An unpinned, real, plain project. Specifically excluded:
- Pinned projects — pinning is an explicit "keep this here" instruction and outranks the sort.
- Virtual / plugin projects (Decks, Flowcharts, Workflows, tools, and the rest) — they are built-in surfaces, not things you "use often."
Folder membership does NOT disqualify a project. An earlier version of this feature refused to reach into groups at all; measured against a real 155-project install, 149 of those projects sat inside a group, leaving 2 eligible rows and making the feature a no-op for anyone who actually organizes their sidebar. The pass partitions by folder and ranks within each folder (and among the loose rows) instead.
Drag behaviour while it is on
With the sort on, reordering the middle zone is switched off — by drag and by the keyboard move — because the order on screen is no longer your saved order (a refused keyboard move is announced with that reason). Pinned rows can still be reordered in the top zone. With the sort off, drag behaves exactly as it always has. Turn the sort off if you want to rearrange by hand.
Who it is for
Someone with many projects who actively works across a shifting subset. If you have few projects, or have not started sessions recently, turning this on does very little: the ranking has nothing to distinguish, so the order barely moves. Every project still shows.
History — why there is no "Rarely Used" group
Until 2026-08-28 this feature had a second pass that pulled every project with no recent sessions into a collapsed Rarely Used group at the bottom. It was removed after it blanked two users' sidebars.
The flaw was in the signal. The recent-session count is computed from the renderer's
live session list, and archived sessions are not in it — they live in a separate
list that is only fetched on demand and is empty at startup. So a count of 0 means
"nothing live right now", not "never used". Archive your conversations and every
project reads as dormant, the demote sweeps them all into the collapsed group, and the
sidebar renders nothing but headings and an "Add Hub" button. One reporter hit this
with 262 archived sessions against 6 live ones and lost all 11 of her hubs, through
restarts and a reboot.
It was reported twice. The first response (2026-08-24) added a "Showing 0 of 11 — Show all" rescue notice over the hiding; the second reporter was on a build that predated even that. The cure was to stop hiding: fixing the count alone would not have been enough, because a perfect archive-aware count still blanks the sidebar of anyone who simply has not started a session in 30 days.
The rule this leaves behind: rank, sort, or badge on a heuristic signal — never
gate visibility on one, least of all a signal that is a lower bound rather than a
true total. See
projects-active-filter-contract.md,
sort-by-usage-ranks-it-never-hides.
Related
The other side nav display choices — show only active (show-only-active-projects.md) and collapsing the sidebar (sidebar-collapse.md) — live in the same ⋮ menu, and the Installed Plugins page decides which tools appear at all (sidebar-items-visibility.md).
Last verified 2026-09-23