Feature/follow automation

[iamsyg]

/claim #206

Description

This PR adds a fully automated JSON workflow for X.com that scrolls the home feed and follows every user encountered in visible tweets. It leverages the execute_sequence tool and uses XPath selectors to interact with tweet dropdowns and follow buttons dynamically.

Type of Change

• Bug fix
• [ X ] New feature
• Breaking change
• Documentation update
• Other:

How It Works

1. Navigate to https://x.com/home
2. Wait for tweets to load (using data-testid='cellInnerDiv')
3. For each visible tweet:
   • Scrolls into view
   • Clicks the tweet's dropdown caret
   • Waits for the dropdown to appear
   • If the dropdown includes a Follow option (and not "Unfollow"):
     • Clicks Follow
     • Waits briefly
     • Presses Escape to close dropdown
   • If Follow is not found, skips and closes dropdown
4. Scrolls down to load more tweets
5. Repeats steps above for n scroll cycles (default: 2)
6. Stops if no new tweets are loaded

Video Demo

Screen.Recording.2025-07-28.062233.mp4

AI Review & Code Quality

• [ X ] I asked AI to critique my PR and incorporated feedback
• [ X ] I formatted my code properly
• [ X ] I tested my changes locally

Checklist

• [ X ] Code follows project style guidelines
• [ X ] Added video demo
• [ X ] Updated documentation if needed

[louis030195]

lol

we dont even support this kind of selector

[iamsyg]

Yeah actually, I just checked the Terminator cheat sheet, I wasn’t aware we don’t support that kind of selector. This is my first time contributing to Terminator, so thanks for the heads-up! I’ve made the necessary changes in the JSON file, do check it out and let me know if anything else needs fixing. Also, I’ve implemented a similar automation flow in Selenium with Python, happy to share that too if it helps. @louis030195

[louis030195]

there is no value in your code if you did not test it and made sure works

otherwise i can reproduce this PR in 2s typing a prompt from my phone, while on the toilet, on cursor background agent

[iamsyg]

Yeah, I Claude the JSON in 2 seconds, looks fancy, works like nothing. Anyone can prompt that on the toilet. I’ve got an actual working Selenium script if we’re done LARPing config.