# XRay

Source: https://sonpiaz.com/projects/xray
ID: https://sonpiaz.com/projects/xray#entity

Turns an X thread into a structured research report for a person or an agent.

Status: Live
Started: 2026-05
Updated: 2026-09-12
Tier: side

## The problem

The most current thinking in AI often lives in long threads on X, and reading them properly takes an hour. Scrapers return raw text with no structure, and a timeline client is built for scrolling, not for understanding.

## The approach

Fetch the thread and its replies, cache them, and have a model turn the whole conversation into a structured report with sources. It ships as a command line tool and as an MCP server, so an agent can call it directly.

## Where it is now

Shipped at v1.0.1 in May 2026, public and open source.

## What happens if this works

Research on social platforms becomes something an agent does with citations, instead of something a person does by scrolling.

## Evidence

- [721 unit tests passing at v1.0.1](https://github.com/sonpiaz/xray)
- 10 releases shipped in a single day

## Links

- [repo](https://github.com/sonpiaz/xray)