Pin Cap walkthroughs to the matching Linear issue

Every hour on weekdays, find new Cap recordings with a Linear issue ID in the title and post the video link as a comment on that issue.

Agentic Task
CapLinearEngineeringData SyncNotifications & Alerts
PromptCreate

Build me an agent workflow that watches my team's Cap recordings and pins each one to the matching Linear issue whenever the recording's title mentions a Linear issue ID.

Trigger: cron, every hour on weekdays (Monday through Friday, roughly 9am to 6pm in my timezone).

Each run, the agent should:

1. Call Cap's List Videos operation to fetch the most recent recordings. Paginate enough to cover anything created since the last run; an hour of recordings will easily fit in one page.

2. For each video, scan the title for a Linear issue identifier matching the pattern UPPERCASE-PREFIX dash NUMBER (for example ENG-412, FE-9, OPS-1024). Match the first identifier found. If the title has no clean identifier, skip the video silently.

3. For each matched video, call Linear's Add Comment to Issue operation using the extracted identifier as the issueId. The comment body should be one short line: "Walkthrough recording attached: <title> (<duration as Mm Ss>) <video link>".

4. Maintain a lightweight persistent memory of which (videoId, issueId) pairs have already been commented on, and skip any pair that is already in memory so we never comment twice for the same recording on the same issue. Start with empty memory on the first run.

5. If a Linear comment call fails (issue not found, prefix doesn't match a team in the workspace, permission error), log the failure and continue with the next video. Do not retry the same failure on future runs; move on.

Run quietly. If there is nothing new to comment on, do nothing and exit. No Slack or email notification step is needed.

Additional information

What does this prompt do?
  • Watches your Cap library every hour during the workday for new walkthrough recordings.
  • Reads each recording's title and looks for a Linear issue ID like ENG-412 or FE-9.
  • Posts a short comment with the video title, duration, and Cap link directly on the matching Linear issue.
  • Remembers what it has already commented so the same recording never gets pinned twice.
What do I need to use this?
  • A Cap account with a developer Secret Key (created at cap.so/dashboard/developers).
  • A Linear workspace you can sign in to, with permission to comment on issues.
  • A naming habit on your team where Cap recording titles include the related Linear issue ID, for example: ENG-412 repro for the upload bug.
How can I customize it?
  • Change the schedule so it runs less often or only at end of day.
  • Tweak the comment template, for example to include who recorded the walkthrough.
  • Restrict which Linear team prefixes the agent reacts to so only ENG-* (or any subset) recordings get pinned.

Frequently asked questions

Do I have to rename my recordings for this to work?
Just include the Linear issue ID somewhere in the recording title, like ENG-412 upload bug repro. Anything without a clean ID is skipped quietly.
Will it spam the same issue every hour?
No. The agent remembers which recordings it has already pinned to which issues and skips them on future runs.
What if I have multiple Linear teams?
It uses the Linear account you connect and matches whatever issue prefix appears in the title. You can also limit it to a specific set of team prefixes during setup.
Does Cap support webhooks for this?
Not yet. Cap does not push real-time events, so the agent checks for new recordings on a schedule instead.
What happens if the issue ID in the title does not exist in Linear?
The agent logs the miss and moves on without retrying, so a typo in one title cannot block other recordings from being pinned.

Stop hunting for the Cap link when you open a Linear issue.

Connect Cap and Linear once, and Geni quietly pins every new walkthrough to the right issue throughout the workday.