jodie 0.1.0

Jodie lets you add contacts to Contacts.app on macOS from command line

Jodie

A command line tool to quickly save new contacts to Contacts.app on macOS.

Named for Jodie Foster for her stellar performance in Contact.

Installation

git clone [e-mail]:austinogilvie/jodie.git
cd jodie
pip install .

After installation, both jodie and jodie-cli commands are available.

Quick Start

# Smart parsing (default) - jodie figures out what's what
jodie new "John Doe" [e-mail] "Acme Inc" "CEO"

# Preview before saving
jodie new "John Doe" [e-mail] --dry-run

# Parse from clipboard (copy an email signature first)
jodie new --paste

# Parse from stdin
echo "John Doe <[e-mail]>" | jodie new --stdin

Usage

jodie - Manage macOS Contacts.app from command line!

Usage:
    jodie new TEXT... [options]
    jodie new [options]
    jodie new --paste [options]
    jodie new --stdin [options]
    jodie new --explicit EMAIL NAME [COMPANY] [TITLE]

Arguments:
    TEXT          Text for jodie to parse intelligently (default mode).
    EMAIL         Email address (used with --explicit).
    NAME          Full name (used with --explicit).
    COMPANY       Company name (used with --explicit).
    TITLE         Job title (used with --explicit).

Options:
    --explicit                      Use strict positional parsing.
    --paste                         Read input from clipboard (pbpaste).
    --stdin                         Read input from stdin (pipe/heredoc).
    -D --dry-run                    Preview parsed fields without saving.

    -E EMAIL --email=EMAIL          Email address.
    -F FIRST --first=FIRST          First name.
    -L LAST --last=LAST             Last name.
    -U NAME --full-name=NAME        Full name (or use --name).
    -P PHONE --phone=PHONE          Phone number.
    -T TITLE --title=TITLE          Job title.
    -C COMPANY --company=COMPANY    Company name.
    -W URL --websites=URL           Comma-separated website URLs.
    --linkedin=URL                  LinkedIn URL (auto-labeled).

    -H --help                       Show this screen.
    -V --version                    Show version.

Examples

Smart Parsing (Default)

Just pass the information in any order - jodie figures it out:

jodie new "John Doe" [e-mail] "Acme Inc" "CEO" "https://linkedin.com/in/johndoe"

Preview with --dry-run

See what jodie parsed before saving:

jodie new "John Doe" [e-mail] "Acme Inc" --dry-run

Output:

┌─────────────────────────────────────────────────────────┐
│                     Contact Preview                     │
├──────────────┬──────────────────────┬───────────────────┤
│ Field        │ Value                │ Source            │
├──────────────┼──────────────────────┼───────────────────┤
│ First Name   │ John                 │ parsed (100%)     │
│ Last Name    │ Doe                  │ parsed (100%)     │
│ Email        │ [e-mail]        │ parsed (100%)     │
│ Company      │ Acme Inc             │ parsed (100%)     │
└──────────────┴──────────────────────┴───────────────────┘

Run without --dry-run to save this contact.

Parse Email Signatures from Clipboard

Copy an email signature to your clipboard, then:

jodie new --paste --dry-run

Jodie handles common signature formats:

• Strips pronouns (he/him, she/her, they/them)
• Splits on bullet separators (•, |, —)
• Filters out reply headers and forwarded message noise
• Infers company from email domain

Parse from Stdin

Pipe text directly:

echo "Jane Smith <[e-mail]> | CEO | Startup Inc" | jodie new --stdin

Or use a heredoc:

jodie new --stdin << 'EOF'
Jane Smith
CEO, Startup Inc
[e-mail]
415-555-1234
https://linkedin.com/in/janesmith
EOF

Explicit Flags

For full control, use explicit flags:

jodie new \
    --first "John" \
    --last "Doe" \
    --email "[e-mail]" \
    --phone "[phone]" \
    --title "CEO" \
    --company "Acme Inc" \
    --linkedin "https://linkedin.com/in/johndoe" \
    --websites "https://acme.com,https://github.com/johndoe"

Strict Positional Mode

If you prefer explicit ordering (email first, then name, company, title):

jodie new --explicit [e-mail] "John Doe" "Acme Inc" "CEO"

Note: --explicit mode doesn't support --dry-run. Use smart parsing with --dry-run to preview first.

Flag Aliases

For convenience, these aliases are supported:

Primary	Aliases
--first	--first-name, --firstname
--last	--last-name, --lastname
--full-name	--name
--websites	--website

Known Limitations

• Notes field: Currently disabled due to macOS entitlement requirements. Will be re-enabled in a future update.

License

MIT