// Send and respond to direct messages (DMs) between agents and sessions in EITS. Activates when a message starts with "DM from:" (incoming DM) or when an agent needs to DM another session/agent. Covers: parsing incoming DMs, replying, proactively sending messages.
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | eits-dm |
| description | Send and respond to direct messages (DMs) between agents and sessions in EITS. Activates when a message starts with "DM from:" (incoming DM) or when an agent needs to DM another session/agent. Covers: parsing incoming DMs, replying, proactively sending messages. |
DMs arrive as a prompt starting with:
DM from:<sender_name> (session:<from_session_uuid>) <message_body>
Parse: sender name, from_session_uuid, message body. Reply immediately.
eits dm --to <from_session_uuid> --message "Your reply here"
--from defaults to $EITS_SESSION_UUID — omit it.
Rules:
eits dm.eits dm --to <session_uuid_or_integer_id> --message "text"
--to accepts both UUID and integer session ID. Use $EITS_SESSION_UUID or $EITS_SESSION_ID — both work.
DM to inactive sessions returns HTTP 422. Sessions in waiting, completed, or failed states are not reachable — the controller returns 422 (not 500). The session must resume before it can receive DMs. Use eits teams status <id> --wait instead of DM-based completion polling where possible.
Send DMs sequentially — never in parallel Bash calls. One error cancels sibling calls:
# Correct
eits dm --to $UUID_1 --message "..."
eits dm --to $UUID_2 --message "..."
Useful when you know agents DM'd you but you can't check the web UI:
eits dm inbox # inbox for current session (default limit 20)
eits dm inbox --session <uuid|id> # inbox for any session
eits dm inbox --limit 50 # up to 100 max
eits dm inbox --since "2026-04-30T12:00:00Z" # only messages after timestamp
eits dm inbox --since-session # only messages since this session started
eits dm inbox --from <session_id> # filter by sender (UUID or integer ID)
eits dm inbox --team-only # only DMs from sessions in shared teams
# alias: eits dm list (identical)
Use --since-session when resuming — DMs have no read/ack state, so prior-session worker DMs replay on every resume. --since-session resolves the session's created_at from the API and uses it as a --since filter, suppressing stale DMs automatically.
Returns {session_id, session_uuid, count, messages[]}. Messages are ordered oldest-first.
| Variable | Value |
|---|---|
EITS_SESSION_UUID | Your session UUID (default --from); --to also accepts $EITS_SESSION_ID |
EITS_AGENT_UUID | Your agent UUID |
DM from:coordinator (session:f47ac10b-...) What's the status of the auth module?
eits dm --to f47ac10b-... --message "Auth module 80% done — JWT validation complete, session persistence in progress."
eits dm --to $AGENT_UUID --message "Task #817 is still in-progress. Complete the task completion sequence and DM back."
eits dm --to 2920 --message "Done. PR merged." # integer ID also works