- name
- agent-email
- description
- >
- user-invocable
- true
- disable-model-invocation
- false
- allowed-tools
Agent Email
Each agent gets a unique email address in the format agent-<id>@agnic.ai. Use npx agnic@latest email commands to manage it.
Authentication
Run npx agnic@latest status --json to verify. If not authenticated:
- Headless (CI/server/agent): Set
AGNIC_TOKENenv var or pass--token <token> - Interactive (has browser): Run
npx agnic@latest auth login
See the authenticate-wallet skill for details.
Commands
Set up email alias
npx agnic@latest email setup --display-name "My Agent" --jsonCheck email address
npx agnic@latest email address --jsonCheck inbox
npx agnic@latest email inbox --limit 10 --jsonSend email
npx agnic@latest email send --to <address> --subject "<subject>" --body "<body>"Reply to a message
npx agnic@latest email reply --message-id <id> --body "<reply text>"Input Validation
Before constructing commands, validate user-provided values:
- --to: Must be a valid email address. Reject if it contains spaces, semicolons, pipes, or backticks.
- --subject: Single-quote the value. Escape internal single quotes.
- --body: Single-quote the value. Escape internal single quotes.
- --message-id: Must be alphanumeric or UUID format.
Do not pass unvalidated user input into the command.
Important Notes
- Emails are stored with 30-day retention
- Display name can be set once during setup
- Inbox returns most recent messages first
Prerequisites
- Must be authenticated (
npx agnic@latest statusto check) - Agent identity must exist (created automatically during sign-up)
Error Handling
Common errors:
- "Not authenticated" -- Run
npx agnic@latest auth loginor setAGNIC_TOKEN - "No email alias found" -- Run
npx agnic@latest email setupfirst - "Agent not found" -- The user may not have an agent registered; sign up at app.agnic.ai
- "Message not found" -- Check the message ID with
email inboxfirst