Identity fields

Personal fields stored in ~/.cues/IDENTITY.md, usable by blanks. In the default mode the model receives each field's name and never its value.

Identity fields: names sent, values kept local

Names are sent; values are substituted locally

After the answer returns, on your machine.

what leaves your machine

email me at [EMAIL]

what you end up with

email me at you@example.com

The model is told a field called email exists, answers with the token, and your machine replaces the token with the real value. The address is never included in a request, so no provider's logs hold it.

The substitution runs in both directions

Values you typed yourself are also replaced before sending.

A phone number you typed into the line would otherwise travel with the next request. Before any text is sent, values matching your fields are replaced with their field names, and restored in what you see afterwards. Values too short or too common to match safely are skipped, with a logged warning.

you wrote

call me on 07700 900123 tomorrow _

what was sent

call me on [PHONE] tomorrow

The protection therefore does not depend on entering details via a blank. It applies however the value got into the line.

What it covers

Defined in ~/.cues/IDENTITY.md; managed directly or with opencues identity.

FieldUsed for
firstName, lastNamewriting about yourself, signing off
email, phonethe details you retype most
jobTitle, company, workCityintroductions and applications
github, linkedin, websitelinks you paste often

Fields live at the top of the file, one per line between the --- markers; prose below them is ignored. Deleting the file removes the feature's data; browser users also clear the copy the sync host pushed to the extension by syncing once more.

Two edge cases

Invented fields, and brackets you typed yourself.

A model sometimes invents a field name it was never given. A token in the answer that matches no defined field is dropped rather than filled, so an invented name cannot become invented data in your text.

Square brackets you typed yourself are preserved. A line that genuinely contains [EMAIL] stays as typed rather than being replaced with your address.

The raw mode

identity-context-mode: raw sends real values. Default: safe.

raw includes the actual values in requests. Answers can be better, because the model sees the real data; the values are then in the provider's logs, which the default mode exists to prevent. safe is the default, and off disables the feature. raw is set by editing the file only; the settings menu does not offer it.

The file alone sends nothing

Fields travel only with underscore requests, and as names only, unless raw is set. Nothing is sent while you are just typing.