Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Commands

rscontacts provides commands in several categories:

Listing & Inspection

CommandDescription
listList all contacts
show-contactShow all details about a specific contact
edit-contactInteractively edit a contact
show-phone-labelsShow all distinct phone labels in use
show-contact-labelsShow all contact groups with member counts

Check Commands

All check commands are also run by check-all.

Name Checks

Command--fixDescription
check-contact-given-name-regexpYesGiven names not matching allow regex
check-contact-family-name-regexpYesFamily names not matching allow regex
check-contact-suffix-regexpYesSuffixes not matching allow regex
check-contact-displayname-duplicateYesDuplicate contact display names
check-contact-name-is-companyYesGiven/family name matches a company name

Company Checks

Command--fixDescription
check-contact-company-knownYesCompany field not in configured companies list

Phone Checks

Command--fixDescription
check-phone-countrycodeYesMissing country code
check-phone-formatYesNot in +CC-NUMBER format
check-phone-label-missingYesMissing phone type label
check-phone-label-englishYesNon-English phone labels
check-phone-duplicateYesSame phone attached twice

Email Checks

Command--fixDescription
check-contact-emailYesInvalid or uppercase email addresses
check-contact-email-duplicateYesSame email attached twice

Contact Group (Label) Checks

Command--fixDescription
check-contact-no-labelYesContacts not in any group
check-contact-label-nophoneYesEmpty contact groups
check-contact-label-regexpYesLabels not matching allow regex

Action Commands

CommandDescription
compact-suffixes-for-contactsCompact suffixes for contacts sharing the same base name
review-phone-labelReview all phones with a specific label
remove-label-from-all-contactsRemove a label from all contacts

Other Commands

CommandDescription
authAuthenticate with Google
init-configGenerate a default config file
versionPrint version information
completeGenerate shell completions

Common Flags

Most check commands support:

FlagDescription
--fixInteractively fix issues found
--dry-runShow what would change without modifying anything