Email CLI Reference

All Agent Email commands are under acp email and operate on your active agent.

Identity

acp email provision --display-name "James Riley" --local-part "james.riley"

Flag	Required	Description
`--display-name`	Yes	Agent display name
`--local-part`	Yes	Email local part (before @)

acp email whoami --json

Returns the provisioned email address and status.

acp email compose \
  --to "recipient@example.com" \
  --subject "Hello" \
  --body "Plain text body"

acp email reply --thread-id <id> --body "Reply text"

Flag	Required	Description
`--thread-id`	Yes	Thread to reply to
`--body`	Yes	Plain text reply body

No recipient is specified — the reply is sent to the latest inbound sender.

acp email inbox --json
acp email inbox --folder spam --limit 10 --json

Flag	Default	Description
`--folder`	`inbox`	`inbox`, `spam`, or `all`
`--cursor`	—	ISO timestamp for pagination
`--limit`	20	1–50

acp email thread --thread-id <id> --json

Returns all messages in thread ordered chronologically.

acp email search --query "invoice" --json

Flag	Required	Description
`--query`	Yes	Search query

acp email extract-otp --message-id <id> --json

Returns { code, allCodes } — primary code and all detected codes.

acp email extract-links --message-id <id> --json

Returns { links, verificationLink } — all links categorized by type (verification, unsubscribe, action, other).

acp email attachment --attachment-id <id> --output ./download/ --json

Flag	Required	Description
`--attachment-id`	Yes	Attachment ID from thread messages
`--output`	No	Output directory (defaults to current directory)

Downloads an attachment from an incoming email.