The moment it happens

Announce new releases on LinkedIn and X when your changelog changes

When your README or CHANGELOG changes on GitHub, a release announcement is written from the changes and posted on LinkedIn and X.

Runs: The moment it happens
Apps: LinkedIn, X
AI: Yes, uses the built-in AI allowance
Access: LinkedIn w_member_social; X tweet.write

Send this to your assistant

Create a ClickRuntime automation: when I push a change to CHANGELOG.md in my GitHub repo, read what changed, write a release announcement for LinkedIn and a short one for X, and post both.

Paste it into your assistant. It tells you what it will send or change before it runs live.

Add to ChatGPT Add to Claude

First time? Adding ClickRuntime to your assistant takes about two minutes.

Why use it

Why teams use this automation

An open-source maintainer ships a release every few weeks but rarely announces it beyond the changelog. Users miss new features, and the project looks quieter than it is.

Now every changelog update becomes an announcement: a LinkedIn post that explains what's new and why it matters, and a short X post with the highlights, both posted as soon as the change is pushed.

What you get out of it

Every release gets announced
No more shipping features nobody hears about.
Written from the real changes
Announcements describe what actually changed, from your changelog.
Plain words for users
Technical entries become benefits people understand.
No extra step in your release
Updating the changelog is the trigger.

How it works

What happens, step by step

GitHub tells ClickRuntime when you push to your main branch, and the signature is checked.
If the changelog or README changed, it fetches what was added.
AI writes a LinkedIn announcement and a short X post from those changes.
Both are published, to LinkedIn and X.

Before it runs live

Connect LinkedIn
Connect X
Paste your automation's link into the other app's webhook settings

What you get

RunsThe moment it happens

Announce new releases on LinkedIn and X when your changelog changesjust nowSucceeded

X · @northwind_devv2.4 is out: offline mode, 40% faster sync, and dark mode by popular demand.

Build your own

Need it to work differently?

This template is a starting point. Copy the prompt and change it, or describe a different automation from scratch, with your own conditions, more apps or an AI step. Your assistant writes it, tests it and runs it on ClickRuntime.

Your own rules
Conditions, thresholds, filters and exceptions, written the way you'd explain them to a colleague.
Any number of apps
One automation can read from one app and update several others. Over 248 apps are ready, and anything with an API works too.
AI where it helps
Summaries, classification, extraction and drafts use ClickRuntime's built-in AI, with no extra key.
On a schedule or on each event
Runs as often as every 5 minutes, or the moment an app sends an event, and keeps track of what it already handled.

Changes you can ask for

Act only on the items that match your own rules, and skip the rest
Change what the AI looks for, or how it writes the result
Add another app, for example also send it to Slack
Combine it with other LinkedIn and X steps into one automation

Under the hood

The code that runs this automation

This is the Python script that runs each time the automation starts. Your AI assistant writes it for you when you send the prompt, and you allow each step in your assistant. To change how the automation works, describe the change to your assistant and it updates the script for you. For every function it can use, see the script reference.

announce_github_releases_on_linkedin_and_x.pyexample

from clickruntime import on_event, credentials, http, ai, verify

AUTHOR, FILES = "urn:li:organization:12345", ("CHANGELOG.md", "README.md")

@on_event
def handle(event):
    if not verify.github(event.body, event.header("X-Hub-Signature-256"), credentials.secret("GITHUB_WEBHOOK_SECRET")):
        return {"rejected": True}
    push = event.json or {}
    changed = {f for c in push.get("commits", []) for f in c.get("modified", [])}
    if push.get("ref") != "refs/heads/main" or not changed & set(FILES):
        return {"skipped": True}
    diff = http.get(push["compare"], headers={"Accept": "application/vnd.github.diff"}).text[:8000]
    posts = ai.generate(f"Release changes:\n{diff}\nWrite a LinkedIn announcement (under 900 chars) and an X post (under 250 chars).",
                        max_output_tokens=600, json_schema={"type": "object",
                        "properties": {"linkedin": {"type": "string"}, "x": {"type": "string"}}}).json
    http.post("https://api.linkedin.com/rest/posts",
              headers={"Authorization": f"Bearer {credentials.connection('linkedin', 'work')}", "LinkedIn-Version": "202409"},
              json={"author": AUTHOR, "commentary": posts["linkedin"], "visibility": "PUBLIC", "lifecycleState": "PUBLISHED",
                    "distribution": {"feedDistribution": "MAIN_FEED"}})
    http.post("https://api.twitter.com/2/tweets", json={"text": posts["x"]},
              headers={"Authorization": f"Bearer {credentials.connection('x', 'work')}"})
    return {"announced": True}

FAQ

Common questions

Which changes trigger an announcement?

Pushes that change CHANGELOG.md or README.md on your main branch. Other pushes are ignored.

Is the webhook verified?

Yes. GitHub signs each delivery, and the signature is checked before anything is posted.

Can I preview first?

Ask for drafts to be emailed for approval instead of posting straight away.

What permissions does it need?

LinkedIn w_member_social; X tweet.write. Nothing else in your accounts is used.

Does it need AI?

Yes. It uses ClickRuntime's built-in AI, so you don't need an OpenAI or Anthropic key. Every plan includes a monthly AI allowance.

How many runs does it use?

One run for each event the app sends.

Can I change how it works?

Yes. Describe the change to your AI assistant, for example a different schedule, channel or filter. It updates the automation, tests it and tells you what changed.

The moment it happensAI