send / send-file / edit / delete / react / mark-read

send

Send a text message via LOCO WRITE command.

openkakao-rs send <chat_id> "message" [OPTIONS]

When --json is set, a successful send returns:

{"chat_id": 382416827148557, "log_id": 123456789, "status": "sent"}

If you use -y, you must also allow unattended send behavior:

• CLI: --unattended --allow-non-interactive-send
• or config: mode.unattended = true and send.allow_non_interactive = true

Unattended sends are rate-limited by safety.min_unattended_send_interval_secs so a bad wrapper cannot burst messages immediately.

Messages are prefixed with 🤖 [Sent via openkakao] by default. Use the global --no-prefix flag to disable:

openkakao-rs --unattended --allow-non-interactive-send --no-prefix send <chat_id> "raw message" -y

send-file

Send a file (photo, video, or document) via LOCO SHIP+POST.

openkakao-rs send-file <chat_id> <file> [OPTIONS]

As with text sends, -y requires unattended send permission.

The media type is auto-detected from file magic bytes:

send-photo

Alias for send-file. Identical behavior.

openkakao-rs --unattended --allow-non-interactive-send send-photo <chat_id> photo.jpg -y

edit

Edit a message via LOCO REWRITE command.

openkakao-rs edit <chat_id> <log_id> "new message" [OPTIONS]

When --json is set:

{"chat_id": 382416827148557, "log_id": 123456789, "status": "edited"}

As with send, -y requires unattended send permission.

delete

Delete a message via LOCO DELETEMSG. The message is replaced by a system feed (feedType:14) in DM chats.

openkakao-rs delete <chat_id> <log_id> [OPTIONS]

When --json is set:

{"chat_id": 382416827148557, "log_id": 123456789, "status": "deleted"}

As with send, -y requires unattended send permission (--unattended --allow-non-interactive-send or the equivalent config).

react

Add a reaction to a message via LOCO ACTION command.

openkakao-rs react <chat_id> <log_id> [OPTIONS]

When --json is set:

{"chat_id": 382416827148557, "log_id": 123456789, "reaction_type": 1, "status": "reacted"}

mark-read

Mark messages as read up to a specific logId via LOCO NOTIREAD. This is a fire-and-forget command — no response is expected from the server.

openkakao-rs mark-read <chat_id> <log_id> [OPTIONS]

When --json is set:

{"chat_id": 382416827148557, "watermark": 123456789, "status": "marked_read"}