# respectGitignore

> The key that hides git-ignored files from the @ picker.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** respectGitignore setting

## Think of it like

It is like a list of drawers your friend should not open. The picker skips them.

## Definition

respectGitignore is a settings key that decides if the @ file picker skips the files your .gitignore lists. The default is true, so ignored files such as build output do not show. Set it to false to see them too. In /config it is called Respect .gitignore in file picker.

## Example

Jack needs Claude to read a log file that git ignores. He sets respectGitignore to false, and the file shows up after @.

## Example code

```json
{
  "respectGitignore": false
}
```

Show ignored files in the @ picker too.

## Why it matters

Ignored files are often noise, but now and then the one you need is among them.

## Common mistake

Thinking it stops Claude from reading those files. It only changes the @ picker list.

## Three principles

- **Hides ignored files.** From @.
- **On by default.** true.
- **Picker only.** Not reading.

## Related terms

- [.gitignore](https://learn.benibix.com/term/development/gitignore)
- [fileSuggestion](https://learn.benibix.com/term/ai/file-suggestion-setting)

---

Source: https://learn.benibix.com/term/ai/respect-gitignore-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.
