Settings

Settings live in one file, config.json, in the folder mail doctor shows. Each profile has its own part, and defaults apply to every profile. This page lists how to see and change them.

mail ya config show
mail ya config set limit 50
mail ya config unset limit

A profile made by session start also holds the mailbox: address, login (when it is not the address), imap_host, imap_port, imap_security (tls or starttls) and folders (the folders sync reads). The app password is not a setting: it lives in the keyring, or in MAIL_PASSWORD for a run that has no keyring.

config show lists each setting and where it came from: the file, a variable or the default.

config set also lists settings for search, speech and embeddings (embedding_*, speech_model, picture_search and others). Every WireCat CLI shares that list. mail ignores them.

PermissionsCopy Anchor Link

permissions decides what a command may do for this profile: allow, ask, readonly or deny, per permission key. Over MCP there is no one to ask, so ask lets the command run. MAIL_READ_ONLY=1 refuses every write, whatever the permissions say.

Run recordsCopy Anchor Link

A command that fails is kept as a run, for mail runs list and runs show. record_input decides whether a run keeps the words you typed; it is true unless you set it to false. Secrets are masked either way; see Security.