Every VS Code window, by project name

What Flick does with VS Code

• One row per window. Five projects open in five windows are five rows, not one VS Code icon, on every Space and display, full-screen and minimized windows included.
• Titled by VS Code. VS Code sets each window's title from its window.title setting. On a Mac the default is the active file's name, then the workspace's name, then the profile's name when you're not in the default profile, separated by em dashes, as in index.ts — billing-api (VS Code source).
• Found by any part of it. Flick searches the window's title as well as the app, so a project name, a file name, “code” or “vsc” all find it (window search).

Find a window by project name

1. Open Flick

   Hold ⌥ and tap Tab, from VS Code or any other app.

2. Type part of the project name

   For a window titled index.ts — billing-api, “bill” is enough. When several windows match, the best match comes first and ties go to the window you used last (how results are ranked). Add a second word to narrow it down: every word has to match.

3. Let go

   The window comes to the front, switching Space if it's on another one.

Want the project name first in each row? Set window.title to ${rootName}${separator}${activeEditorShort} in VS Code's settings; VS Code's documentation explains the setting, and its description in VS Code's Settings lists every variable.

If VS Code windows don't show

VS Code is built with Electron (VS Code FAQ), and some Electron apps report their windows to Accessibility only when they're asked. Flick asks for you once it sees one of the app's windows on your current Space. So if VS Code shows up as a single row with “No windows”, bring one of its windows onto the Space you're in and open Flick again. The details are in missing Electron app windows.

Two other things leave a window out on purpose: the free version lists only your 5 most recent windows, and Show only the active Space leaves out windows on other Spaces.

VS Code's own window switching

• Switch Window... Press ⌃W in VS Code, or run Switch Window... from the Command Palette, for a list of VS Code's windows to pick from (VS Code source).
• ⌘`. Built into macOS, it switches between the windows of the app you're using (Apple).

If you only ever move between VS Code windows, ⌃W does it with nothing else installed. Flick is for when the next window might be a browser, a terminal or a simulator, on any Space: one list for all of them, and the same keys every time.

Cursor

Cursor is based on VS Code's codebase (Cursor docs), but it's an app of its own. Flick lists Cursor's windows under Cursor, apart from VS Code's, with the titles Cursor gives them. If Cursor's windows don't appear, the Electron windows article shows how to check whether an app is built with Electron, and what to do.

Editor tabs

Flick lists VS Code's windows, not the editor tabs inside them: a window's row shows the file that's active in it. Switching straight to a file open in VS Code, Cursor or Xcode is on the roadmap. Coming soon

Using Xcode too? See Flick with Xcode.

Keys

Flick's own keys work the same in every app: see keyboard shortcuts.

Questions