Settings

Settings are the user preferences in refs/gitmsg/core/config of the personal bare repository at ~/.config/gitsocial/personal/.

Commands · Keys · Cross-machine sync · Environment

Commands

gitsocial settings list
gitsocial settings get <key>
gitsocial settings set <key> <value>     # the first set creates the personal repo

GitSocial reads an environment-scoped key from the environment and any other key from the personal repository; a key that is not set takes the default below.

Keys

Key	Type	Default	Meaning
identity.dns_verification	bool	false	trust .well-known/gitmsg-id.json for attestation (IDENTITY.md)
output.color	enum	auto	auto, always, never
display.show_email	bool	false	show the author's email next to the name on cards
display.theme	enum	auto	auto detects the terminal background; light, dark
log.level	enum	info	debug, info, warn, error
extensions.{social,pm,release,review,memo}	bool	true	show the extension in the TUI sidebar
fetch.parallel	int	4	concurrent fetch workers
fetch.timeout	int	30	per-repository fetch timeout, in seconds
fetch.auto.enabled	bool	false	fetch periodically while the TUI is open
fetch.auto.interval	int	300	auto-fetch interval in seconds, minimum 60
fetch.auto.backoff	bool	true	slow auto-fetch while idle; reset when new items arrive
s3.concurrency	int	16	concurrent uploads per s3 push; GITSOCIAL_S3_CONCURRENCY overrides

fetch.workspace_mode is a map from each repository to default or *. The first-fetch prompt writes it, and settings set refuses it.

The registry in library/core/settings/scopes.go defines the core keys. Each extension keeps its user state in refs/gitmsg/<ext>/config of the same repository.

Cross-machine sync

gitsocial personal init --remote [email protected]:me/gitsocial-personal.git
gitsocial personal sync [--push-only | --fetch-only]
gitsocial personal status

Repeat init --remote and sync on each machine. personal sync pushes and fetches refs/heads/* and refs/gitmsg/*; on the config ref, the last write has priority.

Environment

Variable	Effect
XDG_CONFIG_HOME	config root, default ~/.config
GITSOCIAL_PERSONAL_REPO	the personal repository path, default ~/.config/gitsocial/personal
GITSOCIAL_PPROF	cpu, mem or trace: profile this run to /tmp/gitsocial-*
MEMO_SESSION_ID	the active memo session id
MEMO_SESSION_DIR	the memo session directory, default ~/.cache/gitsocial/memo/session

The rest are in CLI.md.