> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowdeck.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Open Quickly (⌘K)

> One search field for every project, session, and action in FlowDeck

**⌘K** opens a search field over the workspace. Type a few letters, hit Return.

It is the fastest way to do almost anything in FlowDeck, and the only one you have to remember —
everything below is reachable from it, whether or not the surface that owns it is on screen.

## What it searches

<CardGroup cols={2}>
  <Card title="Projects and sessions" icon="folder-tree">
    Switch to any open project, jump to a session, start a new one, or close and delete the
    active session.
  </Card>

  <Card title="Build, run, and test" icon="hammer">
    Build, Run, Test, and Clean, plus the scheme and destination to run them on.
  </Card>

  <Card title="Source control" icon="code-branch">
    Commit, push, pull, fetch, publish, open the diff viewer, open a pull request, merge it,
    discard changes, copy the branch name.
  </Card>

  <Card title="Panels and tools" icon="table-columns">
    Show or hide the Changes, Tests, and Issues views; open Simulators & Runtimes, Skills
    Manager, or Disk Cleanup.
  </Card>

  <Card title="Agent setup" icon="robot">
    Change the model, reasoning effort, or permission mode for the active session, and switch
    between Agent and Plan mode.
  </Card>

  <Card title="Settings" icon="gear">
    Session settings, schemes, build settings, Swift packages, xcodebuild arguments, and the PR
    automation toggles.
  </Card>
</CardGroup>

It also reaches out of the app where that is the obvious thing to do: **Open Project in Xcode**,
**Reveal Project in Finder**, and **Open the active worktree folder**.

## Things worth knowing

**It shows you what an action will do.** Results carry a one-line description — "Push this branch
to its remote", "Reclaim disk space used by FlowDeck and Xcode" — so you are not guessing from a
verb.

**Unavailable actions say so rather than disappearing.** An action that cannot run right now — a
merge with no pull request, a push with nothing to push — is listed and marked, so you can tell
"not applicable yet" from "not a feature".

**Toggles report their current state.** Settings that are on or off, such as auto-merging
monitored PRs or deleting the remote branch after a merge, show **Currently on** or
**Currently off** in the result, so flipping one from the palette is not a coin toss.

**Model and effort are per session.** Setting them here applies to the session you are in, the
same as changing them in the composer.

<Tip>
  If a shortcut has slipped your mind, ⌘K is faster than finding the menu. If you never learn
  another shortcut, learn this one.
</Tip>