# Quick Open

Source: https://athas.dev/docs/quick-open

Open files by name with fuzzy search, recent files, previews, and keyboard navigation.

Quick Open is the fastest way to navigate to any file in your project using fuzzy search.

## Open Quick Open

- `Cmd+P` (macOS) / `Ctrl+P` (Windows/Linux)
- `Cmd+K` (macOS) / `Ctrl+K` (Windows/Linux)

## Navigate Results

- Type to filter files using fuzzy search
- Use `Arrow Up` / `Arrow Down` to move through results
- Press `Enter` to open the selected file
- Press `Esc` or `Cmd+K` / `Ctrl+K` to close

## File Categories

Results are grouped and prioritized in this order:

1. **Open** — files currently open in editor tabs (marked with a blue badge)
2. **Recent** — recently visited files ordered by frecency (marked with a clock icon)
3. **Other** — remaining project files sorted alphabetically

## Fuzzy Search

Quick Open uses fuzzy matching so you don't need to type exact file names:

- Type `utl` to match `utils.ts`
- Type `appcss` to match `app/styles.css`
- Short queries (1–2 characters) require a substring match for precision

## File Preview

When **Quick Open Preview** is enabled (Settings > Appearance), a preview pane appears on the right side showing the content of the currently selected file.

- Hover over a file to preview it
- Navigate with keyboard to update the preview automatically
- Toggle the setting to hide the preview and get a narrower layout

**Tip:**

  Quick Open caches the project file index after the first open, so subsequent opens are instant.
  The index refreshes automatically when you switch projects.

## Ignored Files

Quick Open automatically excludes files and directories that are not useful for navigation:

- Build output: `dist/`, `build/`, `out/`, `.next/`
- Dependencies: `node_modules/`, `target/`
- Lock files: `bun.lockb`, `yarn.lock`, `Cargo.lock`
- Generated files: `*.map`, `*.min.js`, `*.min.css`
- VCS: `.git/`

## If a file is missing

Confirm the active project, clear the query and check ignored files. Quick Open matches names, not file contents. Use [Search](https://athas.dev/docs/search) for text inside files and [Editing](https://athas.dev/docs/editing) for tab and save actions.