Keyboard Navigation & Vim Controls

Taxon provides complete keyboard-driven navigation, enabling power users and developers to manage projects, navigate views, and control timers without touching the mouse.

---

Positional Vim Navigation (g <cat> <proj>)

Jump directly to any project in your workspace using two-stage numeric chords:

Step 1: Press 'g'          ───▶  Transient numeric badges appear on sidebar
Step 2: Press Category '2' ───▶  Filters down to Category 2 projects
Step 3: Press Project  '1' ───▶  Instantly opens Category 2, Project 1

• Badge Hints: Pressing g activates overlay badges on categories and projects.
• Sliding Timeout: You have 1.5 seconds between keystrokes before the jump chord resets automatically.
• Cancel Chord: Press Esc anytime to cancel an in-progress chord.

---

Global View Jump Chords

Navigate directly between high-level application views:

Chord	Target View	Description
g d	Dashboard	System overview, active sprints, and quick stats
g p	Projects	All projects gallery
g t	Todo List	Unified task list across all active projects
g c	Calendar	Scheduled timeline and due dates
g w	Work Log	Pomodoro session history and daily accomplishments
g r	Recurring	Automated recurring task definitions
g a	Analytics	Velocity metrics and First-Pass Success Rate
g s	Settings	Data sync, appearance, and database backups
Alt 1..9	Pinned Project	Switch directly to pinned project slot 1 through 9
j / k	Item Navigation	Move selection down / up through lists

---

Global Hotkeys

Shortcut (macOS)	Shortcut (Linux/Win)	Action
⌘K	Ctrl+K	Open Spotlight Search & Command Palette
⌘N	Ctrl+N	Quick Add New Task
⌘F	Ctrl+F	Toggle Distraction-Free Focus Mode
⌘⇧P	Ctrl+Shift+P	Start / Pause Active Pomodoro Timer
⌘⇧S	Ctrl+Shift+S	Stop & Reset Pomodoro Timer
?	?	Toggle Keyboard Shortcuts Cheatsheet modal
Esc	Esc	Universal Escape (Dismiss topmost overlay)

---

Universal Escape Stack (Esc)

The Esc key unwinds user interface layers in deterministic reverse hierarchy:

1. Topmost Modal: Closes open dialogs (e.g. Diff Viewer, Revision Request, Project Settings).
2. Flyout Menus: Dismisses active dropdowns, date pickers, and filter popovers.
3. Pending Chords: Clears active g Vim jump states.
4. Fullscreen Modes: Exits Pomodoro Focus Mode or Workflow Theater Mode.