gf

a cli for viewing texts from loved ones (macOS)

Installation

If you have Rust and Cargo installed, you can install from source:

git clone https://github.com/justinwangx/gf-cli.git
cd gf-cli
cargo install --path .

Usage

Configure a default contact

# Set a default contact
gf --set 2125551234
# Set the display name for the default contact
gf --name "John"

Check the last received message

# See the last message received from your default contact
gf

# Or specify a contact for one-time use
gf --contact 2125551234

Managing multiple contacts

# Add a named contact
gf add mom 2125551234 --display-name "Mom"

# List all configured contacts
gf list

# Check the last message received from a named contact (case-insensitive)
gf mom

# Remove a contact
gf remove mom

# Show configuration file location (for manual editing)
gf config

How it works

gf reads directly from the macOS Messages database to retrieve the last message received from the specified contact (not messages you sent to them). It displays the message along with a human-readable timestamp.