This is Chris
I was testing out some commands in the README to better understand how the cli works and some of them returned an error so I spun up Codex to look through the code and help me understand what's actually available vs. what's in the README. These changes were a result of that investigation. Here's the prompts I used:

Help me understand the commands available for this cli tool, in particular I want to archive old gmail emails and am looking for the most efficient command to do so. Read through all code so you get a solid understanding of this library and how it's all connected

Let's open a PR with this documentation change, make sure to reference where the new commands exist and reference commits where the old stale commands were removed. Make the description clear without fluff so that it's easy for the maintainer to review the changes and decide to merge

dig deeper in the history, as far as you need to understand and make sure the docs are accurate and up to date

This is Codex:

Summary

• remove stale Gmail label update/delete + batch --query examples
• replace with implemented commands (labels modify, batch delete/modify, filters --add-label)
• update batch thread examples to use search + labels modify pipeline

Evidence

• Implemented commands: internal/cmd/gmail_labels.go, internal/cmd/gmail_batch.go, internal/cmd/gmail_filters.go, internal/cmd/gmail.go
• Stale commands only appear in docs commit d2be673; no corresponding code addition/removal commits found via history search

Testing

• not run (docs only)