Getting Started
Get Jeff up and running in under 5 minutes.
Prerequisites
- macOS or Linux (Windows via WSL)
- A Google account with Gmail enabled
- An Anthropic API key
- Terminal emulator with Unicode support
Installation
Homebrew (macOS/Linux)
brew install 2389-research/tap/jeff Binary Download
Download the latest release from the downloads section.
Setup
Run the setup wizard to configure your Anthropic API key:
jeff setup Or set your API key directly:
jeff setup-token YOUR_ANTHROPIC_API_KEY
Configuration is stored in ~/.jeff/config.yaml.
Google Authentication
Jeff uses OAuth 2.0 to securely connect to your Google account. No passwords are stored locally.
jeff auth google This will open your browser to complete the Google OAuth flow. Grant Jeff access to:
- Gmail (read, compose, send, archive, label)
- Google Calendar (read, create, update events)
- Google Tasks (read, create, complete tasks)
- Google Contacts (read)
Tokens are stored locally in ~/.jeff/tokens/gmail.json.
First Run
Launch Jeff in interactive mode:
jeff You'll see the TUI interface. Try asking:
> summarize my inbox Jeff will connect to Gmail and give you a summary of your recent messages.
Verify Installation
Check that everything is working:
jeff doctor# Checks API key, Google auth, and system health
The doctor command will verify your installation and show any configuration issues.