At Email Cli

Use the AgentTeam Email CLI command `at-email` to operate an agent mailbox. Use when the user wants to check mailbox status, list inbox messages, read safe message content, search mail, mark messages read, archive messages, send email, reply to email, use JSON output for automation, check CLI version/update status, or install/launch the CLI when the skill is available but `at-email` is not installed.

Use at-email as the command name. at-email-cli is only the app/package folder name.

First Step

When the user asks you to operate email, first check whether the CLI is available:

command -v at-email
at-email --version

If at-email is missing, see Install Or Run If Missing at the end of this skill.

Runtime Configuration

The CLI reads its connection settings from environment variables. Do not invent credentials or print secret values.

Required for most mailbox commands:

AT_EMAIL_WILDDUCK_API_BASE_URL
AT_EMAIL_WILDDUCK_ACCESS_TOKEN
AT_EMAIL_WILDDUCK_USER_ID

Optional but useful:

AT_EMAIL_MAILBOX_ADDRESS

Required for safe message reads:

AT_EMAIL_CONTROL_API_BASE_URL
AT_EMAIL_MESSAGE_READ_TOKEN

If configuration is missing, run the command and relay the CLI's exact missing variable message rather than guessing values.

Output Mode

Use text mode for human-readable summaries:

at-email inbox --unseen

Use --json when parsing output, chaining commands, or reporting structured results:

at-email inbox --json --limit 10

In JSON mode, successful JSON is written to stdout and errors are written to stderr so stdout stays machine-readable.

Common Commands

Check configured mailbox status:

at-email status

List inbox messages:

at-email inbox
at-email inbox --unseen
at-email inbox --limit 50
at-email inbox --folder INBOX --json

Read a message through the safe message-read path:

at-email read 123
at-email read 123 --json

Search mail:

at-email search "invoice"
at-email search "from:[e-mail]" --limit 20 --json

Mark or archive a message:

at-email mark-read 123
at-email archive 123

Send a message:

at-email send --to [e-mail] --subject "Hello" --body "Message body"

Reply to a message:

at-email reply 123 --body "Thanks, received."
at-email reply 123 --all --body "Thanks, everyone."

Check version and updates:

at-email version
at-email self-update

When installed through npm, self-update is disabled because npm owns the installed package version. Update notices still tell the user how to update the npm package.

Workflow Patterns

For "check my mail", run:

at-email status
at-email inbox --unseen

For "read the latest message", run:

at-email inbox --json --limit 1
at-email read <message_id>

For "reply to this message", inspect the message first unless the user already provided enough context:

at-email read <message_id>
at-email reply <message_id> --body "<reply>"

For automation, prefer --json, parse the returned IDs, then call the follow-up command with the selected message_id.

Install Or Run If Missing

Prefer the npm package for the easiest bootstrap:

npx --yes @agentteamhq/email@latest --version

For one-off use, prefix the intended command with npx --yes:

npx --yes @agentteamhq/email@latest inbox --unseen

For a persistent install, ask before modifying the user's global tools, then run:

npm install -g @agentteamhq/email
at-email --version

If npm is unavailable or a standalone binary is required, download the matching at-email_X.Y.Z_<os>_<arch>[.exe] asset and checksums.txt from the agentteamhq/agentteam-email GitHub Release, verify the checksum, place the binary on PATH, and run at-email --version.