# Configuration files

All of these live in the configuration folder: `~/.config/tratto/` on Linux (or `$XDG_CONFIG_HOME/tratto/`),
`~/Library/Application Support/tratto/` on macOS, or `$TRATTO_CONFIG_DIR` when it is set. Each file starts with a
`schema` number; tratto refuses a file it cannot read whole and tells you where it is wrong.

## Files you edit

| File | Schema | What it is | Applies |
|---|---|---|---|
| `settings.json` | 3 | your settings, `{"schema": 3, "values": {…}}` | at start (the Settings screen applies at once) |
| `profiles/<name>.json` | 3 | the settings of a profile | at start |
| `projects/<workspace>/<project>.json` | 3 | the settings of one project | at start |
| `style.json` | 1 | colours, radii, text, fonts, icons and spacing over the theme | live |
| `layout/refs.json`, `sidebar.json`, `history_columns.json`, `repository.json`, `notifications.json` | 1 | the layouts of the Git screens | live |
| `layout/ide.json`, `ide/project_types.json`, `ide/file_icons.json` | 1 | the IDE's layout, project types and file icons | at start |
| `themes/<built-in theme>.json` | 1 | an adjustment of a built-in theme | at start |
| `locales/<language>.json` | 1 | texts over a built-in language, or a new language | at start |
| `flows/clone.json` | 2 | the clone flow | at start |
| `updates.json` | 1 | an update feed that replaces the built-in one | at the next check |
| `agents/prices.json` | 1 | model prices for the cost estimate | at start |

## Files tratto manages

Leave these to the app: `workspaces.json`, `pins.json`, `session.json`, `ide-memory.json`, `activity.json`,
`home/pages/`, `copilot/chats/`, `agent-token`, `db/`. On Linux, the Trash of discarded files is kept in
`~/.local/state/tratto/`.

## Built in, not overridable yet

`menu.json` (the menus and keys), the settings schema, the command book, the AI prompts for commits and the What's New
list ship with the app and are read only from it.

## Environment variables

| Variable | What it does |
|---|---|
| `TRATTO_CONFIG_DIR` | use another configuration folder |
| `TRATTO_GIT` | an absolute path to the `git` to run |
| `TRATTO_MODE` | the module to start on |