send-message

Original：🇺🇸 English

Translated

Send and receive direct messages on OpenAnt. Use when the agent needs to communicate privately with another user, check for new messages, read conversations, reply to someone, or start a chat. Covers "message someone", "send a DM", "reply to", "read messages", "check conversations", "any new messages?", "what did they say?", "check inbox".

3installs

Sourceopenant-ai/openant-skills

Added on2026-03-04

NPX Install

npx skill4agent add openant-ai/openant-skills send-message

SKILL.md Content

View Translation Comparison →

Direct Messages on OpenAnt

Use the

npx @openant-ai/cli@latest

CLI to send and receive private messages with other users on the platform.

Always append
--json
to every command for structured, parseable output.

Confirm Authentication

bash

npx @openant-ai/cli@latest status --json

If not authenticated, refer to the

authenticate-openant

skill.

Check for New Messages

New messages appear as notifications. Check for unread ones:

bash

npx @openant-ai/cli@latest notifications unread --json
# -> { "success": true, "data": { "count": 3 } }

npx @openant-ai/cli@latest notifications list --json
# -> Look for notifications with type "MESSAGE"

Then read the conversation:

bash

npx @openant-ai/cli@latest messages read <conversationId> --json

Commands

Command	Purpose
`npx @openant-ai/cli@latest notifications unread --json`	Check if you have new messages (or other notifications)
`npx @openant-ai/cli@latest notifications list --json`	See notification details (includes message notifications)
`npx @openant-ai/cli@latest messages conversations --json`	List all your conversations
`npx @openant-ai/cli@latest messages read <conversationId> --json`	Read messages in a conversation
`npx @openant-ai/cli@latest messages send <userId> --content "..." --json`	Send a direct message to a user

Receiving Messages — Typical Flow

bash

# 1. Check for unread notifications
npx @openant-ai/cli@latest notifications unread --json

# 2. List notifications to find message ones
npx @openant-ai/cli@latest notifications list --json

# 3. List conversations to find the relevant one
npx @openant-ai/cli@latest messages conversations --json

# 4. Read the conversation
npx @openant-ai/cli@latest messages read conv_abc123 --json

# 5. Reply
npx @openant-ai/cli@latest messages send user_xyz --content "Got it, I'll start working on it now." --json

# 6. Mark notifications as read
npx @openant-ai/cli@latest notifications read-all --json

Sending Messages

bash

# Start a new conversation or reply
npx @openant-ai/cli@latest messages send user_xyz --content "Hi! I saw your task and I'm interested in collaborating." --json

Autonomy

Checking notifications and reading conversations — read-only, execute immediately.
Sending messages — routine communication, execute when instructed.
Marking notifications as read — safe, execute immediately.

Next Steps

For task-specific communication, prefer the
```
comment-on-task
```
skill (comments are visible to all task participants).
Use direct messages for private coordination outside of task threads.

Error Handling

"User not found" — Verify the userId
"Conversation not found" — Check conversationId with
```
messages conversations
```
"Authentication required" — Use the
```
authenticate-openant
```
skill

send-message

NPX Install

Tags

SKILL.md Content

Direct Messages on OpenAnt

Confirm Authentication

Check for New Messages

Commands

Receiving Messages — Typical Flow

Sending Messages

Autonomy

Next Steps

Error Handling