Documentation

FlyTo navigator

Jump to directories, files, git branches, and bookmarks from the command palette.

FlyTo is toowl's unified fuzzy navigator — a palette mode for jumping around your workspace without leaving the keyboard.

Open FlyTo

PlatformShortcut
macOSCmd+Shift+O
Linux / WindowsCtrl+Shift+O

You can also open the command palette (Cmd+Shift+P / Ctrl+Shift+P) and choose FlyTo.

What you can jump to

  • Recent directories — scored by frecency and persisted per workspace in state.json
  • Parent and sibling directories — quick .. navigation from the active pane's cwd
  • Bookmarks — paths listed under [bookmarks] in ~/.config/toowl/config.toml
  • Files in cwd — a fast, ignore-aware scan (respects .gitignore)
  • Git branches — cached branch list with TTL refresh

On select

Choosing a directory injects cd 'path' into the active PTY via bracketed paste — no new shell spawn.

Choosing a file opens it in your $EDITOR in a new pane when configured, or pastes the path into the terminal.

Bookmarks example

[bookmarks]
projects = "~/Projects"
notes = "~/Documents/notes"

Tips

  • FlyTo uses the active pane's cwd — split panes with different directories get context-aware results.
  • Recent dirs reset when you switch workspaces; they are not global history.