Mouse support

jiq has two main areas: the query input (where you type) and the output area (where results appear). Both respond to the mouse — click, scroll, and drag work alongside keyboard shortcuts.

What you can do with the mouse

Gesture Where What happens
Click Query input or output area Make that area active for keyboard input
Click Input field Position cursor at click location
Click Autocomplete Highlight a suggestion
Double-click Autocomplete Apply a suggestion
Double-click Output area row Drill into the value on that row (same as >)
Click [ < Back ] badge on results border Step back to prior query (same as <); only visible when there’s something to undo
Click + drag Output area Select multiple lines
Scroll wheel Output area Scroll vertically
Horizontal swipe (two fingers) Output area Scroll left/right through wide lines
Scroll wheel Input field Scroll horizontally through long queries
Horizontal swipe (two fingers) Input field Pan horizontally through long queries
Hover History popup row Reveal the delete button
Click delete button History popup Delete that entry
Click Help popup tab Switch to that tab
Click Scrollbar Reposition the scroll thumb
Drag Scrollbar thumb Drag to scroll

Horizontal scroll works on terminals that emit horizontal scroll events (for example Ghostty, kitty, and WezTerm). Inside tmux it requires tmux 3.4 or newer to forward those events through to jiq.

Select and copy with the mouse

To copy specific output lines:

  1. Click and drag across the lines you want in the output area.
  2. The selected lines highlight as you drag.
  3. Press y to copy the selection to your clipboard.

You can also start a selection with the keyboard by pressing v, then extend with j/k.

Mouse and keyboard together

Mouse actions don’t interfere with keyboard state. You can:

  • Click a suggestion in autocomplete, then keep typing
  • Scroll results with the wheel, then press > to zoom into the value under your cursor
  • Drag-select lines, press y to copy, then continue editing the query

Whichever area you last clicked receives keyboard input. Click to switch, or use Shift+Tab.