nongio/otto/send-to-phone

Send to the phone

Messages from a chat app reach you through the chat bridge, cc-connect. Your text replies go back to the chat on their own; files and pictures do not. Send them with:

cc-connect send --image /home/<you>/Pictures/Screenshots/otto-files-20260927-191500.png --message "The Files window"
cc-connect send --file /home/<you>/Documents/report.pdf

• `--image` for png, jpg, gif and webp; `--file` for anything else. Up

to 50 MB. --message adds a caption.

• Absolute paths under the home folder. You run with a private /tmp that

cc-connect cannot see, so save what you make (a screenshot, an export) under ~/Pictures/Screenshots or your working folder, never /tmp.

• One command per call, as written here. Don't chain them with &&,

pipes or sleep: each command on its own is what the person has allowed once, and anything else asks them again, on their phone.

• Only say it was sent once the command says so. `Message sent

successfully.` means it is in the chat. Otherwise, say where the file is and what went wrong:

• cc-connect is not running: no chat bridge is on.
• no active session found: the bridge is on, but this conversation is not

coming from the chat right now: it was typed at the desk, or the bridge restarted since the last message from the phone. Their next message from the chat fixes it; don't say the bridge is off.

• Send what was asked for. A file goes to the person's own chat, but it

still leaves the computer: don't send anything they did not ask for.

Taking a screenshot

Use this skill's scripts/screenshot, by its full path under the skill's base directory. It prints the path of the picture it took:

<skill dir>/scripts/screenshot                 # the whole screen, every monitor
<skill dir>/scripts/screenshot otto-files      # Files brought to the front first
<skill dir>/scripts/screenshot -o eDP-1        # one monitor

• The app is its app id: otto-files, otto-settings, firefox… The

otto-help skill's desktop page says how to find one. no window of … is open means that app has no window: say so rather than capturing something else.

• It is the whole screen. Otto cannot crop to one window yet, so the

picture can show more than was asked for: other windows, notifications. Say so when you send it.

• Don't use grim or a screenshot harness directly: the script is the one

that is allowed without asking.

Then send the path it printed with cc-connect send --image.