Skip to content

v0.2.0

Choose a tag to compare

@turian turian released this 20 Jan 22:13
· 8 commits to main since this release
7337889

What's New

Draft Commands (Safe for AI Agents)

  • email.draft - Create new draft emails without sending
  • email.draft-reply - Create draft replies to existing emails with auto-threading

Features

  • Auto-sets In-Reply-To and References headers for proper threading
  • Auto-prefixes Re: to subject when replying
  • --reply-all flag to include all original recipients
  • --from flag to specify sender identity
  • --to and --subject overrides

Safety Model

Drafts are created using Email/set only - never EmailSubmission/set. Even with a write-enabled token, the CLI cannot send emails. Humans review drafts in Fastmail UI before sending.

Other Changes

  • Renamed FASTMAIL_READONLY_API_TOKEN → FASTMAIL_API_TOKEN (backwards compatible)
  • Fixed @file/@- body input to read plain text (not JSON)
  • CLI help now shows fastmail-cli instead of jmapc-cli

Example Usage

# Create a draft reply
fastmail-cli email.draft-reply \
  --id "M12345" \
  --body "Thanks for reaching out..." \
  --from "joseph@noc0.dev"

# Create a new draft
fastmail-cli email.draft \
  --to "recipient@example.com" \
  --subject "Hello" \
  --body @message.txt

Full Changelog: v0.1.1...v0.2.0