Preferences

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

~/.synti/preferences.json

This file is distinct from the main 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.

preferences.json

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

Editing preferences

In the app
By hand

Run the /prefs command to edit your details interactively. Changes apply to your next session.

Quit Synti, edit ~/.synti/preferences.json in a text editor, and relaunch. Keep the JSON valid.

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.

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 and is changed from Settings.
Language — set under Settings → Appearance → Language. This controls both the interface language and the language the agent replies in.

A language field in older preferences.json files is ignored. Use Settings → Appearance → Language instead.

Config File

App state and the theme setting.

Environment Variables

Relocate the config directory that holds preferences.

Credentials

Where secrets are kept, separate from preferences.

LLM Connections

Choose which model answers you.

CLI

Configuration

Server

Where preferences live

Fields

Editing preferences

Appearance and language

Config File

Environment Variables

Credentials

LLM Connections

​Where preferences live

​Fields

​Editing preferences

​Appearance and language

​Related

Config File

Environment Variables

Credentials

LLM Connections

Where preferences live

Fields

Editing preferences

Appearance and language

Related