Add MRU sort for session tree #9

New issue

Open

opened 2026-06-12 04:46:57 +00:00 by ldraney · 2 comments

ldraney commented

2026-06-12 04:46:57 +00:00

Owner

Type

Feature

Lineage

Standalone -- discovered while documenting session management (#5).

Repo

ldraney/tmux-custom

User Story

As a tmux user with many sessions
I want my most recently used sessions at the top of the session list
So that I can switch between active sessions without scrolling

Context

tmux's choose-tree sorts sessions alphabetically by default. Rebinding prefix + s to choose-tree -sO time sorts by most recently used instead. Active sessions float to the top naturally.

Originally considered luytbq/tmux-session-manager for J/K manual reorder, but MRU sort makes manual reorder unnecessary -- tested and confirmed.

File Targets

Files to modify:

.tmux.conf -- add choose-tree -sO time binding
docs/session-management.md -- document MRU sort behavior

Files NOT to touch:

docs/config-reference.md -- update separately
docs/plugins.md -- no new plugins

Feature Flag

none

Acceptance Criteria

Ctrl+b s opens session tree sorted by most recently used
Session management docs reflect new sort behavior

Test Expectations

Ctrl+b s shows sessions in MRU order
No regressions in existing session navigation

Constraints

Must not conflict with existing plugin bindings

Checklist

PR opened
No unrelated changes

tmux-custom -- project

### Type Feature ### Lineage Standalone -- discovered while documenting session management (#5). ### Repo `ldraney/tmux-custom` ### User Story As a tmux user with many sessions I want my most recently used sessions at the top of the session list So that I can switch between active sessions without scrolling ### Context tmux's `choose-tree` sorts sessions alphabetically by default. Rebinding `prefix + s` to `choose-tree -sO time` sorts by most recently used instead. Active sessions float to the top naturally. Originally considered `luytbq/tmux-session-manager` for J/K manual reorder, but MRU sort makes manual reorder unnecessary -- tested and confirmed. ### File Targets Files to modify: - `.tmux.conf` -- add `choose-tree -sO time` binding - `docs/session-management.md` -- document MRU sort behavior Files NOT to touch: - `docs/config-reference.md` -- update separately - `docs/plugins.md` -- no new plugins ### Feature Flag none ### Acceptance Criteria - [ ] `Ctrl+b s` opens session tree sorted by most recently used - [ ] Session management docs reflect new sort behavior ### Test Expectations - [ ] `Ctrl+b s` shows sessions in MRU order - [ ] No regressions in existing session navigation ### Constraints - Must not conflict with existing plugin bindings ### Checklist - [ ] PR opened - [ ] No unrelated changes ### Related - `tmux-custom` -- project

ldraney commented

2026-06-13 07:03:25 +00:00

Author

Owner

Scope Review: NEEDS_REFINEMENT

Review note: review-1416-2026-06-13

Issue body is well-scoped and template-complete. All file targets verified against the codebase. No conflicts with existing bindings or plugins detected. Two traceability gaps prevent READY status:

[SCOPE] project-tmux-custom note does not exist in pal-e-docs -- cannot verify user story story:session-management against a project page. Create project page with user-stories section.
[SCOPE] arch-tmux-config note does not exist in pal-e-docs -- no backing architecture note for the arch:tmux-config label. Create architecture note arch-tmux-config.

Once these backing notes are created, the ticket is ready for next_up.

## Scope Review: NEEDS_REFINEMENT Review note: `review-1416-2026-06-13` Issue body is well-scoped and template-complete. All file targets verified against the codebase. No conflicts with existing bindings or plugins detected. Two traceability gaps prevent READY status: - **[SCOPE]** `project-tmux-custom` note does not exist in pal-e-docs -- cannot verify user story `story:session-management` against a project page. Create project page with user-stories section. - **[SCOPE]** `arch-tmux-config` note does not exist in pal-e-docs -- no backing architecture note for the `arch:tmux-config` label. Create architecture note `arch-tmux-config`. Once these backing notes are created, the ticket is ready for next_up.

ldraney commented

2026-06-13 07:06:58 +00:00

Author

Owner

Scope Review: READY

Review note: review-1416-2026-06-13-r2
Re-review after refinement -- both previous [SCOPE] items resolved. Traceability triangle complete, all file targets verified, template sections present. Ticket is ready to move to next_up.

## Scope Review: READY Review note: `review-1416-2026-06-13-r2` Re-review after refinement -- both previous [SCOPE] items resolved. Traceability triangle complete, all file targets verified, template sections present. Ticket is ready to move to next_up.