# ADR-0062: Hide dotfiles in the files pane by default

- **Status:** Accepted
- **Date:** 2026-09-04
- **Deciders:** jka
- **Decision:** D62

## Context

The files pane listed `.git/`, `.gitignore` and other hidden entries, cluttering a
narrow pane. `ls` hides them by default, and Windows Explorer has a "Hidden items"
option.

## Decision

The files pane hides entries whose names start with `.` unless View ▸ Show Hidden
Files is on. The filter is applied when the pane renders; `fs.list` in the core still
returns every entry, because hiding is a presentation choice.

The setting has three controls bound to one variable and one applier: the View menu
item, the Preferences checkbox, and a glyph button in the files pane header. The
header glyph shows the state: `◉` when hidden files are shown, `◌` when they are
hidden. Its tooltip (ADR-0063) changes with it.

## Consequences

- The default matches the Unix convention.
- The setting persists with the other view preferences.