Usage Guide

Master the Jeff TUI and common workflows.

Interactive Mode

The default mode. Opens the full TUI for back-and-forth conversation:

jeff

You can also start with an initial prompt:

jeff "what's on my calendar today?"

This opens the TUI with your prompt already submitted.

For quick queries that print results and exit, use the --print flag:

jeff --print "how many unread emails do I have?"
# Or shorthand:
jeff -p "count my unread emails"

Output formats for scripting:

jeff -p "next meeting" --output-format json
jeff -p "next meeting" --output-format stream-json

Jeff saves conversation history. Resume your most recent conversation:

jeff --continue

Or resume a specific conversation by ID:

jeff --resume abc123

View and search your conversation history:

jeff history
jeff history search "project phoenix"

Favorite important conversations:

jeff favorite abc123
jeff favorites

> what's urgent in my inbox?
> summarize emails from the last 24 hours
> show me emails I haven't replied to

> draft a reply to the latest email from Sarah
> compose an email to team@company.com about the Q4 report
> send the draft

> what's on my calendar today?
> schedule a meeting with Alex tomorrow at 2pm
> find a free slot this week for a 1-hour meeting

> show my tasks
> add a task to follow up with the client
> mark the first task as done

Jeff supports multiple TUI themes:

jeff --theme dracula
jeff --theme gruvbox
jeff --theme nord

Set a default theme in your config file.