Common Issues

CLI Not Found

Symptom:

dispatch: command not found

Fix:

• Re-run install script.
• Restart shell session.
• Confirm CLI is in your PATH.

Claim Link Expired

Fix:

• Re-run dispatch inbox claim and use the new URL.

Unable to Send Mail

Fix checklist:

1. Confirm inbox is claimed to your workspace.
2. Confirm plan/usage is not blocking sends.
3. Retry with minimal payload (--to, --subject, --text).

OTP Extraction Returns Nothing

Fix checklist:

1. Run dispatch mail list and confirm message arrival.
2. Use explicit message ID with dispatch mail extract otp --message-id <id>.
3. Verify the message actually contains a passcode format.