jeff

module

v0.3.20 Latest Latest Go to latest Published: Jan 1, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/2389-research/jeff

Links

Open Source Insights

README ¶

Jeff

A productivity AI agent CLI powered by Claude. Manage your email, calendar, and tasks through natural conversation.

Install

# macOS/Linux
brew install 2389-research/tap/jeff

# Or download from releases
# https://github.com/2389-research/jeff/releases

Setup

# Set your Anthropic API key
export ANTHROPIC_API_KEY=your-key-here

# Connect Google account (Gmail, Calendar, Tasks)
jeff auth google

# Verify setup
jeff doctor

Usage

# Start interactive mode
jeff

# One-off query
jeff --print "What's on my calendar today?"

# Resume last conversation
jeff --continue

What Can Jeff Do?

Google Services

After jeff auth google, you can:

Email (Gmail)

Search and read emails
Send, reply, forward emails
Archive, label, delete emails
Mark as read/unread

Calendar

List and search events
Create, update, delete events
Find free time slots
Accept/decline/tentative invitations

Tasks

Create and manage tasks
Mark tasks complete
List tasks by list

Contacts

Search contacts
Read contact details

File & Code Operations

Read, write, edit files
Search code with regex (ripgrep)
Find files by pattern (glob)
Execute shell commands

Productivity

Date/time awareness (understands "next Tuesday", timezones)
Task tracking with todos
Web search and fetch
Sub-agent delegation for complex tasks

Commands

jeff                    # Interactive mode
jeff --print "query"    # Single query, exit
jeff --continue         # Resume last conversation
jeff --resume <id>      # Resume specific conversation

jeff auth google        # Authenticate with Google
jeff auth status        # Check auth status
jeff auth logout        # Remove Google auth

jeff doctor             # Check configuration
jeff setup-token <key>  # Save API key to config

Configuration

Config file: ~/.jeff/config.yaml

model: claude-sonnet-4-20250514

Environment variables:

ANTHROPIC_API_KEY - Your Anthropic API key
JEFF_MODEL - Model to use (optional)

Development

make build      # Build binary
make test       # Run tests
make lint       # Run linter
make install    # Install to GOPATH/bin

License

MIT

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
jeff command ABOUTME: Export command to export conversations in multiple formats ABOUTME: Supports Markdown, JSON, and HTML output to stdout or file	ABOUTME: Export command to export conversations in multiple formats ABOUTME: Supports Markdown, JSON, and HTML output to stdout or file
internal
adapter ABOUTME: Adapter that wraps jeff tools to implement mux's tool.Tool interface.	ABOUTME: Adapter that wraps jeff tools to implement mux's tool.Tool interface.
approval Package approval manages persistent approval rules for tool execution.	Package approval manages persistent approval rules for tool execution.
conversation Package conversation provides context window management and message pruning for conversations.	Package conversation provides context window management and message pruning for conversations.
core Package core provides the Anthropic API client and core conversation functionality.	Package core provides the Anthropic API client and core conversation functionality.
export Package export provides conversation export functionality in multiple formats.	Package export provides conversation export functionality in multiple formats.
hooks Package hooks implements the lifecycle hooks system for automation.	Package hooks implements the lifecycle hooks system for automation.
logging Package logging provides structured logging with multiple output formats and levels.	Package logging provides structured logging with multiple output formats and levels.
mcp Package mcp provides Model Context Protocol client and server management.	Package mcp provides Model Context Protocol client and server management.
mux ABOUTME: Backend wrapper around mux agent for Jeff ABOUTME: Provides simplified event streaming interface over agent orchestration	ABOUTME: Backend wrapper around mux agent for Jeff ABOUTME: Provides simplified event streaming interface over agent orchestration
providers Package providers defines the provider interface and registry for productivity tools	Package providers defines the provider interface and registry for productivity tools
providers/gmail Package gmail implements the Gmail productivity provider for Jeff	Package gmail implements the Gmail productivity provider for Jeff
providers/oauth Package oauth provides OAuth2 authentication utilities for productivity providers	Package oauth provides OAuth2 authentication utilities for productivity providers
storage Package storage provides database operations for conversations, messages, and metadata.	Package storage provides database operations for conversations, messages, and metadata.
suggestions Package suggestions provides template suggestion and smart completion functionality.	Package suggestions provides template suggestion and smart completion functionality.
templates Package templates provides template loading and rendering for conversations.	Package templates provides template loading and rendering for conversations.
tools Package tools provides the tool system for extending Jeff with external capabilities.	Package tools provides the tool system for extending Jeff with external capabilities.
tools/holidays Package holidays provides US federal holiday data and operations ABOUTME: Holiday calendar with US federal holidays (2024-2030) ABOUTME: Supports checking if date is holiday, listing holidays, finding next holiday	Package holidays provides US federal holiday data and operations ABOUTME: Holiday calendar with US federal holidays (2024-2030) ABOUTME: Supports checking if date is holiday, listing holidays, finding next holiday
tools/workingdays Package workingdays provides business day calculations ABOUTME: Working days calculator using US federal holidays ABOUTME: Supports checking working days, counting business days, adding business days	Package workingdays provides business day calculations ABOUTME: Working days calculator using US federal holidays ABOUTME: Supports checking working days, counting business days, adding business days
ui Package ui provides the Bubble Tea terminal user interface components.	Package ui provides the Bubble Tea terminal user interface components.
ui/components Package components provides reusable UI components for the TUI.	Package components provides reusable UI components for the TUI.
ui/iface
ui/input
ui/layout Package layout provides consistent border styles and spacing utilities for TUI layout.	Package layout provides consistent border styles and spacing utilities for TUI layout.
ui/messages
ui/status
ui/streaming
ui/themes Package themes provides theming support for the TUI.	Package themes provides theming support for the TUI.
ui/visualization Package visualization provides real-time visualization of token usage and context windows.	Package visualization provides real-time visualization of token usage and context windows.
test
integration