Atlas · fluency
Files and folders
Where agents read and write. A path names a file by the folders that lead to it.
See it working: Plate III
In plain words
Your computer keeps files in folders, and folders can hold more folders. A path such as my-app/src/AGENTS.md lists the folders to walk through to reach one file.
How it works
A path that starts with / begins at the root of the whole disk. Any other path starts from the folder you are in, called the current working directory. Two names are special: . means this folder and .. means the folder above it.
Going deeper
Agents use paths the same way you do. The folder a session starts in decides which instruction files load, and relative paths in its commands are read from there. On Plate III, watch the map as you cd up and down.
Sources
- POSIX.1-2024 Base Definitions: Pathname Resolution The Open Group / IEEE
The special filename dot-dot shall refer to the parent directory of its predecessor directory.
If the pathname begins with a <slash>, the predecessor of the first filename in the pathname shall be taken to be the root directory of the process
shall be taken to be either the current working directory of the process
- Custom instructions with AGENTS.md OpenAI
defaults to ~/.codex
Codex stops searching once it reaches your current directory
Codex includes at most one file per directory.
Quotes were checked against the live pages on 2026-11-08.