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

send

Send a text message via LOCO WRITE command.

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

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

{"chat_id": 900000000000001, "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-cli --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-cli 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-cli --unattended --allow-non-interactive-send send-photo <chat_id> photo.jpg -y

edit

Edit a message via LOCO REWRITE command.

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

When --json is set:

{"chat_id": 900000000000001, "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-cli delete <chat_id> <log_id> [OPTIONS]

When --json is set:

{"chat_id": 900000000000001, "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-cli react <chat_id> <log_id> [OPTIONS]

When --json is set:

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

dry-run

All write commands support --dry-run to preview the action without making any server call.

openkakao-cli send 123 "hello" --dry-run
# [dry-run] Would send to chat 123: "🤖 [Sent via openkakao] hello"

openkakao-cli delete 123 456 --dry-run --json
# {"dry_run": true, "action": "delete", "chat_id": 123, "log_id": 456}

This is safe even without allow_loco_write — no LOCO connection is made.

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-cli mark-read <chat_id> <log_id> [OPTIONS]

When --json is set:

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