Use when you need personal metadata about the user — name, email, ORCID, GitHub username, affiliations, education, or any other personal details. Also use when populating author fields, git identity, paper metadata, profile info, personalized content, or consolidating identity across platforms (linking handles, name variants, and emails so they resolve to the same person).
Query the user's personal metadata store. Fields are organized into core categories (identity, contact, academic, education) and platform profiles (profiles.github, profiles.pypi, profiles.orcid, etc.).
Run deets schema --format json to see all available fields with types,
descriptions, and example values. This is the authoritative source of what
data exists.
# Single value (bare output, pipe-friendly)
deets get identity.name
deets get contact.email
deets get profiles.github.username
# Platform context (all fields for a platform)
deets get profiles.github
deets get profiles.pypi
# Cross-platform queries
deets get profiles.*.email # all platform emails
deets get profiles.*.url # all profile URLs
# With fallback (never fails)
deets get academic.scholar --default ""
# Structured output
deets show --format json # full dump
deets export --format env # DEETS_IDENTITY_NAME="..." format
The identity_web category links name variants, handles, emails, and
profile URLs so that searching any one resolves to the same person.
# All linked identities
deets get identity_web
# Name variants (Alexander Towell, Alex Towell, queelius, etc.)
deets get identity_web.names
deets get identity_web.handles
# All emails across platforms
deets get identity_web.emails
# All profile URLs (GitHub, ORCID, Scholar, social, etc.)
deets get identity_web.urls
Use this when populating CITATION.cff, ORCID profiles, Hugo site configs, or any metadata that benefits from consistent cross-platform identity linkage.
To update, use deets set or deets edit:
deets set identity_web.handles '["queelius", "new-handle"]'
get: bare value, no decoration (pipe-friendly)--format: table, json, toml, yaml, env