# fileSuggestion

> A command of your own that suggests files when you type @.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** fileSuggestion setting, @ file autocomplete

## Think of it like

It is like your own phone book. You use it, not the one that came with your phone.

## Definition

fileSuggestion is a settings key that runs your own command to suggest file paths when you type @. The built-in picker walks through your folders. In a very large repo, a command that reads a ready-made file list can be faster. The key holds an object with type set to command, and the command to run.

## Example

Emma's repo has a million files, and the @ picker is slow. She points fileSuggestion at a script that reads a file index.

## Example code

```json
{
  "fileSuggestion": {
    "type": "command",
    "command": "~/bin/list-files.sh"
  }
}
```

Suggest files from your own script.

## Why it matters

A slow picker breaks your flow every time you name a file.

## Common mistake

Setting it and still seeing the built-in list. Some company rules skip your command without a warning.

## Three principles

- **Your own picker.** For @.
- **For huge repos.** Faster lists.
- **type is command.** Always.

## Related terms

- [respectGitignore](https://learn.benibix.com/term/ai/respect-gitignore-setting)
- [statusLine](https://learn.benibix.com/term/ai/status-line-setting)

---

Source: https://learn.benibix.com/term/ai/file-suggestion-setting
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
