# Single value (great for scripts and $(...) substitution)
deets get identity.name
deets get web.github
deets get contact.email

# With fallback (exit 0, never fails)
deets get identity.nickname --default "friend"

# Check existence without output
deets get web.mastodon --exists && echo "has mastodon"

# Category (all fields)
deets get academic
deets get education

# Cross-category search
deets get *.orcid

# Include descriptions
deets get identity --desc

# Structured output (use --format for any command)
deets show --format json      # full JSON dump
deets show identity           # single category table
deets show --format yaml      # YAML output

# List all field paths
deets keys                    # one per line
deets keys --format json      # JSON array

# List category names
deets categories              # one per line
deets categories --format json

# Inspect field types and metadata
deets schema --format json    # category, key, type, description, example

# Search across everything
deets search "towell"

# Understand field meanings
deets describe academic.orcid
deets describe education.degrees

# Check configuration
deets which --format json     # paths and merge status

# Open metadata file in $EDITOR
deets edit                    # edit global ~/.deets/me.toml
deets edit --local            # edit local .deets/me.toml

# Export for scripts
deets export --format env     # DEETS_IDENTITY_NAME="..." format
deets export --format json    # full JSON
deets export --format yaml    # YAML
deets export --format toml    # TOML

# Set from stdin (useful in pipelines)
echo "new value" | deets set identity.name
git config user.email | deets set contact.email

# Import fields from another TOML file
deets import other.toml --dry-run   # preview
deets import other.toml             # apply

# Compare local vs global
deets diff --format json

# Version info
deets version