mise install       # install Go 1.26
make install       # build and install into /usr/local/bin/hey

# Browser-based OAuth via Launchpad (primary method)
hey auth login

# Or use a pre-generated token
hey auth login --token TOKEN

# Or use a browser session cookie
hey auth login --cookie COOKIE

hey auth status   # check auth status
hey auth token    # print access token for scripting
hey auth refresh  # force token refresh
hey auth logout   # clear credentials

hey boxes                          # list mailboxes
hey box imbox                      # list postings in a box (by name or ID)
hey threads 123                    # read a full email thread
hey reply 123 -m "Thanks!"        # reply to a thread (or omit -m to open $EDITOR)
hey reply 123 --draft -m "Draft"   # save a reply draft without sending
hey compose --to user@example.com --subject "Hello"  # compose a new message
hey compose --draft --to user@example.com --subject "Hello" -m "Draft"  # save a draft without sending
hey compose --to user@example.com --cc bob@example.com --bcc carol@example.org --subject "Hello"  # with CC/BCC
hey drafts                         # list drafts
hey attachments 123                # list attachments in a thread (per entry)
hey attachments download 123       # download every attachment in the thread to ./
hey attachments download 123 --entry 456 --index 1 --output ~/Downloads  # one specific file

hey calendars                      # list calendars
hey recordings 1 --starts-on 2026-01-01 --ends-on 2026-01-31  # list events in a calendar
hey event create "1:1" --calendar-id 1 --starts-at 2026-01-20 --start-time 10:00 --end-time 10:30 --timezone America/New_York --invitee alice@example.com --invitee bob@example.com
hey event update 123 --invitee carol@example.com  # replaces full invitee list
hey event delete 123

hey todo list                      # list todos
hey todo add "Buy milk"            # create a todo
hey todo complete 1                # mark done
hey todo uncomplete 1              # mark undone
hey todo delete 1                  # delete

hey habit complete 1               # mark habit done (today or --date YYYY-MM-DD)
hey habit uncomplete 1             # undo habit completion

hey timetrack start                # start tracking
hey timetrack stop                 # stop tracking
hey timetrack current              # show active track
hey timetrack list                 # list all tracks

hey journal list                   # list entries
hey journal read                   # read today's entry (or pass YYYY-MM-DD)
hey journal write "..."            # write today's entry (or omit content for $EDITOR)

hey skill install   # install the skill globally for your agent

make build   # build binary
make test    # run tests
make lint    # run golangci-lint
make clean   # remove build artifacts