ActUpon Docs

Agent inbox workflow

ActUpon can act as a capture inbox for local coding agents. Mark an item for Codex or Cursor, then let a local tool pull the latest matching capture and save it to disk.

Marker convention

Put one of these markers in the ActUpon instruction note:

@codex
@codex:thecrux
@cursor
@cursor:android

Preferred routing uses explicit markers. Tags like codex, codex:thecrux,cursor, and cursor:android are also accepted.

Matching rules

Explicit note markers win over tags.
Lane-specific markers like @codex:thecrux win over generic @codex.
Plain note mentions of a target word are a fallback only.

Expected local pull shape

A local agent helper should fetch recent items, select the latest match for the requested target, download the original image, and write machine-readable metadata beside it.

export SCREENSHOTACTION_BASE_URL=https://actupon.app
export SCREENSHOTACTION_TOKEN=<agent-token-with-read_items>

npm run actupon-agent -- pull --target=codex --json
npm run actupon-agent -- pull --target=cursor --lane=android --json

The local output convention used in this repo is:

latest.<ext> for the original image.
latest.md for the rendered item summary and OCR.
latest.json for metadata, item ID, match reason, and local paths.