dotshot for Codex

Codex can view images by path. dotshot puts the path on your clipboard.

Codex CLI views local images with its view_image tool when you give it the path, or at launch with --image. On a remote machine the image has to be there first. dotshot sends it over SSH and copies the path.

Download for Mac Set it up
Free and open source · Notarized by Apple · macOS 14+
A terminal running codex on a ROCm machine with a pasted dotshot path

What people send

How it works with Codex

In a session

Paste the path and ask Codex to look at it, e.g. View /home/dev/inbound/rocprofv3-…png and fix the top kernel.

At launch

On the destination, start Codex with the capture attached: codex --image /home/dev/inbound/…png, pasting the path dotshot copied.

Recordings and files

Codex reads frames and files, not video: extract frames with ffmpeg, or let the inbox instructions do it.

Set it up

Five minutes, nothing to install over there.

  1. Install dotshot on your Mac

    Download the notarized DMG from GitHub Releases and allow Screen Recording in its setup. Nothing gets installed on the other machine.

  2. Make sure this Mac can reach it with a key

    ssh -o BatchMode=yes dev@rocm-box true && echo ready

    No key there yet? Run ssh-copy-id dev@rocm-box once. Tailscale names and ~/.ssh/config aliases (including ones with a ProxyCommand) work, because dotshot uses your SSH configuration.

  3. Add it as a destination

    In setup, or from Terminal (or let your agent do it with the setup skill):

    DS=/Applications/dotshot.app/Contents/Resources/dotshot-capture.sh
"$DS" add rocm dev@rocm-box '~/inbound'
"$DS" check rocm

    check creates a private folder, verifies the key and SFTP, and saves the absolute path your agent will see.

  4. Capture

    Press ⌃⌥⌘S and drag, or ⌃⌥⌘V to record. The file lands on the machine and its absolute path is on your clipboard.

Let agents there find what you sent

Append the inbox instructions to the AGENTS.md Codex reads on that machine (trim the front matter if you like).

# Add the dotshot inbox instructions to Codex on the destination machine
curl -fsSL https://raw.githubusercontent.com/mejohnc-ft/dotshot/main/skills/dotshot-inbox/SKILL.md >> AGENTS.md
  • Codex only views files you point it at. A pasted absolute path is exactly that.
  • Codex on your Mac can run the setup skill too: ask it to follow the file.

Also works with

One shortcut for the whole fleet.

Every guide uses the same app: add each machine once, then switch from the pill, a drop tile, or a dotshot:// link.

DGX SparkROCmRemote MacsClaude CodePiOverview