ldraney/tmux-custom
1
0
Fork 0
Code Issues 3 Pull requests 3 Projects Releases Packages Wiki Activity Actions

Add session management documentation #5

New issue
Closed
opened 2026-06-12 04:26:14 +00:00 by ldraney · 0 comments
ldraney commented 2026-06-12 04:26:14 +00:00
Owner
Copy link

Type

Feature

Lineage

Standalone -- first doc in the new docs/ directory.

Repo

ldraney/tmux-custom

User Story

As a tmux user
I want a reference doc for session management commands and philosophy
So that I can quickly look up session navigation without googling

Context

The repo has config but no documentation. Building out a docs/ directory starting with session management -- the most fundamental tmux concept. This is philosophy-first documentation, not just keybinding dumps.

File Targets

Files the agent should modify or create:

  • docs/session-management.md -- new session management reference doc

Files the agent should NOT touch:

  • .tmux.conf -- no config changes in this issue

Feature Flag

none

Acceptance Criteria

  • docs/ directory exists
  • docs/session-management.md covers session mode (Ctrl+b s), prefix commands, CLI usage, resurrect/continuum persistence, and workflow tips
  • Doc takes a philosophy-first approach

Test Expectations

  • Markdown renders correctly
  • Keybinding tables are accurate against current .tmux.conf

Constraints

  • Philosophy-first: explain why, not just what
  • Keep tables scannable for quick reference

Checklist

  • PR opened
  • No unrelated changes

Related

  • Standalone -- no project page yet
### Type Feature ### Lineage Standalone -- first doc in the new docs/ directory. ### Repo `ldraney/tmux-custom` ### User Story As a tmux user I want a reference doc for session management commands and philosophy So that I can quickly look up session navigation without googling ### Context The repo has config but no documentation. Building out a docs/ directory starting with session management -- the most fundamental tmux concept. This is philosophy-first documentation, not just keybinding dumps. ### File Targets Files the agent should modify or create: - `docs/session-management.md` -- new session management reference doc Files the agent should NOT touch: - `.tmux.conf` -- no config changes in this issue ### Feature Flag none ### Acceptance Criteria - [ ] `docs/` directory exists - [ ] `docs/session-management.md` covers session mode (Ctrl+b s), prefix commands, CLI usage, resurrect/continuum persistence, and workflow tips - [ ] Doc takes a philosophy-first approach ### Test Expectations - [ ] Markdown renders correctly - [ ] Keybinding tables are accurate against current `.tmux.conf` ### Constraints - Philosophy-first: explain why, not just what - Keep tables scannable for quick reference ### Checklist - [ ] PR opened - [ ] No unrelated changes ### Related - Standalone -- no project page yet
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
feature/session-reorder
kitty-tmux-optimization
arch-linux
1-revert-to-minimal-config
No results found.
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
ldraney/tmux-custom#5
No description provided.