chihlasm/resolutionflow
1
0
Fork 0
Code Issues 23 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

[Feature] Keyboard-First Session Navigation #52

New Issue
Closed
opened 2026-02-10 15:58:12 +00:00 by chihlasm · 1 comment
chihlasm commented 2026-02-10 15:58:12 +00:00 (Migrated from github.com)
Copy Link

Summary

Enable full keyboard-driven troubleshooting: number keys (1-9) to select decision options, Enter to continue/confirm, Escape to go back, Tab to focus notes field.

Why

  • Engineers troubleshoot while on calls or remoted into machines — mouse-dependent UI slows them down
  • Keyboard shortcuts make the tool feel professional and fast
  • Power users will love it and it increases session throughput
  • Already have useKeyboardShortcuts hook as foundation

Implementation Notes

  • Decision nodes: display number badges (1-9) next to each option, press key to select
  • Action/Solution nodes: Enter to continue, Escape to go back
  • Tab to focus notes textarea, Shift+Tab to return to navigation
  • Show keyboard hints subtly on screen (e.g., small badge on each option)
  • Respect focus — don't capture keys when user is typing in notes/scratchpad
  • Ctrl+/ already toggles scratchpad

Acceptance Criteria

  • Number keys select decision options during active session
  • Enter advances to next step on action/solution nodes
  • Escape navigates back one step
  • Tab focuses notes field, Shift+Tab returns focus
  • Keys disabled when typing in text inputs (notes, scratchpad)
  • Visual keyboard hints on decision options (e.g., "1", "2", "3" badges)

Sources

Priority

Do Now — quick win, power user essential

## Summary Enable full keyboard-driven troubleshooting: number keys (1-9) to select decision options, Enter to continue/confirm, Escape to go back, Tab to focus notes field. ## Why - Engineers troubleshoot while on calls or remoted into machines — mouse-dependent UI slows them down - Keyboard shortcuts make the tool feel professional and fast - Power users will love it and it increases session throughput - Already have `useKeyboardShortcuts` hook as foundation ## Implementation Notes - Decision nodes: display number badges (1-9) next to each option, press key to select - Action/Solution nodes: Enter to continue, Escape to go back - Tab to focus notes textarea, Shift+Tab to return to navigation - Show keyboard hints subtly on screen (e.g., small badge on each option) - Respect focus — don't capture keys when user is typing in notes/scratchpad - Ctrl+/ already toggles scratchpad ## Acceptance Criteria - [ ] Number keys select decision options during active session - [ ] Enter advances to next step on action/solution nodes - [ ] Escape navigates back one step - [ ] Tab focuses notes field, Shift+Tab returns focus - [ ] Keys disabled when typing in text inputs (notes, scratchpad) - [ ] Visual keyboard hints on decision options (e.g., "1", "2", "3" badges) ## Sources - `.claude/docs/ai/resolutionflow/10x/session-1.md` — Small Gems #2 ## Priority **Do Now** — quick win, power user essential
chihlasm commented 2026-02-11 00:43:33 +00:00 (Migrated from github.com)
Copy Link

Implemented in PR #72 (feat/session-quick-wins).

Implemented in PR #72 (feat/session-quick-wins).
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
10x-analysis
From 10x product analysis
 backend
FastAPI/Python work
 bug
Something isn't working
 collaboration
Team sharing, escalation, notifications
 database
PostgreSQL/schema changes
 documentation
Documentation updates
 duplicate
This issue or pull request already exists
 enhancement
Improvement to existing feature
 feature
New functionality
 frontend
React work
 good first issue
Good for newcomers
 help wanted
Extra attention is needed
 integration
PSA, external service integrations
 intelligence
Analytics, AI, data-driven features
 invalid
This doesn't seem right
 priority: high
Do this soon
 priority: low
Nice to have
 priority: medium
Important but not urgent
 question
Further information is requested
 quick-win
Low effort, high value
 strategic
Long-term strategic bet
 ux
User experience improvements
 wontfix
This will not be worked on
No Label 10x-analysis feature frontend quick-win ux
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
chihlasm
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: chihlasm/resolutionflow#52
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?