What is timeline-viewing?

A set of browser scripts for switching between X's For You and Following timelines, scrolling through posts, collecting them, and exporting the results as JSON files. X is the social network formerly known as Twitter.

Use it to collect posts from either timeline, automatically scroll through the feed, limit the number of posts, and export the collected timeline data for later analysis.

It avoids manually switching timelines, scrolling, copying posts, and saving the collected information. Settings control which timeline is viewed, how many posts are collected, and when scrolling stops.

timeline-viewing — Skill for Claude Code and Codex by nirholas: A set of browser scripts for switching between X's…

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add skills/nirholas/xactions/timeline-viewing

Any agent

npx skills add nirholas/XActions --skill timeline-viewing

Clone the repo

git clone --depth 1 https://github.com/nirholas/XActions

Made for: Claude Code, Codex.

Or install xactions, the plugin that ships this one along with the rest of its 47 skills, 1 command, 6 agents, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/nirholas/xactions/timeline-viewing.svg)](https://agentmods.dev/skills/nirholas/xactions/timeline-viewing)

Your own site

<a href="https://agentmods.dev/skills/nirholas/xactions/timeline-viewing"><img src="https://agentmods.dev/badge/skills/nirholas/xactions/timeline-viewing.svg" alt="Measured on agentmods" height="20"></a>

Per session 44 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 643 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.00044	$0.00643
Opus 5	$0.00022	$0.00321
Sonnet 5	$0.00009	$0.00129
Haiku 4.5	$0.00004	$0.00064

Measured 4d ago against content hash 8f397b9e8e79, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

timeline-viewing scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/timeline-viewing/SKILL.md · 80 lines

How it starts

The opening of the file, as written. The whole thing — 80 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Timeline Viewing & Scraping

Browser console scripts for viewing, switching, and collecting posts from your X timeline.

Script Selection

Goal	File	Navigate to
Switch timeline, auto-scroll, export posts	`src/timelineViewer.js`	`x.com/home`
Scrape timeline posts into structured data	`src/timelineScraper.js`	`x.com/home`

Quick Start

Go to x.com/home
Open DevTools (F12) → Console
Paste src/timelineViewer.js → Enter
JSON file auto-downloads when complete

Configuration (`timelineViewer.js`)

const CONFIG = {
  timeline: 'for-you',       // 'for-you' or 'following'
  autoSwitch: true,           // Automatically switch to selected timeline
  collectPosts: true,         // Scroll and collect posts
  maxPosts: 100,              // Max posts to collect
  exportData: true,           // Auto-download JSON when done
  scrollDelay: 2000,          // ms between scroll actions
  delayBetweenActions: 1500, // ms between UI actions
  maxScrollRetries: 8,        // Empty scrolls before stopping
};

Available Functions

// timelineViewer.js
XActions.switchTo('for-you')     // Switch to For You timeline
XActions.switchTo('following')   // Switch to Following timeline
XActions.collect()               // Start collecting posts
XActions.export()                // Export collected posts as JSON
XActions.abort()                 // Stop collection

// timelineScraper.js
XActions.scrape({ maxPosts: 200 }) // Scrape with custom limit
XActions.results()                  // Get collected results
XActions.download()                 // Download as JSON

Output Data Structure

Each collected post includes:

Tweet ID, author, handle, avatar
Tweet text, timestamp
Likes, retweets, replies, views counts
Media URLs (if any)
Is retweet / is quote tweet

Notes

Timeline data is only what's visible/scrolled in your browser session
for-you content is personalized; following shows only accounts you follow
Increase maxPosts for deeper scrapes (slower, more scroll rounds)
Different from twitter-scraping which targets specific profiles, not your feed

Read the full file on GitHub · 80 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

4d ago First seen · 80 lines · 44 tokens per session scan A 8f397b9e8e79

Subscribe to this mod's changes

timeline-viewing is a skill published in the GitHub repository nirholas/XActions (502 stars, last pushed today), licensed Apache-2.0. It adds 44 tokens to every session and 643 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Browser automation ai-agent automation claude gpt mass-unfollow mcp

tmux

Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.

the-open-agent/openagent · 22 tokens

browser-test

Validate a feature works by driving a real browser with Playwright MCP. No test files — just interactive verification.

langwatch/langwatch · 25 tokens

drive-the-ui

Drive the page the user has open through live UI actions. List the actions a page accepts, call them with typed payloads, and read the live state including unsaved edits. Use when the user is looking at a page you can operate, such as the evaluations workbench, and a change should happen in front of them rather than…

langwatch/langwatch · 75 tokens

browser-pair

Collaborative headed browser session for UI work. Launch Playwright Chromium visible to the user, handle auth, then interactively drive the browser while the user watches and gives real-time visual feedback. Edit code and refresh to verify fixes live. Use when the user says 'browser pair', 'paired browser', 'let's…

langwatch/langwatch · 87 tokens

debug-frontend-with-browser

Frontend diagnosis extension for the acceptance skill. Use for intermittent rendering, ordering, stale-state, navigation, virtual-list, React/Zustand, optimistic-update, refresh-dependent, or browser-only failures where the first broken boundary may be DOM, component input, derived state, client cache, network data…

lobehub/lobehub · 118 tokens

design-prototype

Produce an interactive single-file HTML design prototype using the REAL LobeHub design system (@lobehub/ui + antd + antd-style tokens) with production-style React — no build step, opens directly in a browser. Use when asked for a design prototype / interactive mockup / 交互原型 / 出个原型 / 设计稿 HTML for a page or flow, or to…

lobehub/lobehub · 92 tokens