> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synti.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Preferences

> Personal details Synti weaves into the agent's context, plus where appearance and language settings live.

Preferences are the small set of personal details that make the agent's responses fit you — your name, timezone, location, and any standing notes. Synti folds these into the agent's context so it doesn't have to ask again each session. This page covers what's stored, how to edit it, and where the appearance and language settings live separately.

## Where preferences live

```text theme={null}
~/.synti/preferences.json
```

This file is distinct from the main [config file](/reference/config/config-file). It holds personal context, not app state.

## Fields

| Field                 | Description                                                                      |
| --------------------- | -------------------------------------------------------------------------------- |
| `name`                | How you'd like the agent to address you.                                         |
| `timezone`            | Your timezone in IANA format (e.g. `Europe/Berlin`) for accurate scheduling.     |
| `location`            | City, region, and country for location-aware answers.                            |
| `notes`               | Free-form notes about how you like the agent to work.                            |
| `includeCoAuthoredBy` | Add a co-authored-by trailer to git commits the agent makes. Defaults to `true`. |
| `updatedAt`           | Timestamp of the last change, set automatically.                                 |

```json preferences.json theme={null}
{
  "name": "Alex",
  "timezone": "Europe/Berlin",
  "location": "Berlin, Germany",
  "notes": "Prefer concise answers. Use metric units.",
  "includeCoAuthoredBy": true,
  "updatedAt": 1731600000000
}
```

## Editing preferences

<Tabs>
  <Tab title="In the app">
    Run the `/prefs` command to edit your details interactively. Changes apply to your next session.
  </Tab>

  <Tab title="By hand">
    Quit Synti, edit `~/.synti/preferences.json` in a text editor, and relaunch. Keep the JSON valid.
  </Tab>
</Tabs>

<Note>
  These details are included in the agent's system prompt, so timezone, location, and your notes shape every response. Leave a field blank to omit it.
</Note>

## Appearance and language

A couple of settings that feel like preferences live elsewhere because they affect the interface rather than the agent's context.

* **Theme** — the active color theme is the `colorTheme` value in the [config file](/reference/config/config-file) and is changed from Settings.
* **Language** — set under **Settings → Appearance → Language**. This controls both the interface language and the language the agent replies in.

<Warning>
  A `language` field in older `preferences.json` files is ignored. Use **Settings → Appearance → Language** instead.
</Warning>

## Related

<CardGroup cols={2}>
  <Card title="Config File" icon="file-code" href="/reference/config/config-file">
    App state and the theme setting.
  </Card>

  <Card title="Environment Variables" icon="terminal" href="/reference/config/environment-variables">
    Relocate the config directory that holds preferences.
  </Card>

  <Card title="Credentials" icon="lock" href="/reference/config/credentials">
    Where secrets are kept, separate from preferences.
  </Card>

  <Card title="LLM Connections" icon="plug" href="/reference/config/llm-connections">
    Choose which model answers you.
  </Card>
</CardGroup>