X-TOC

Reading navigation and lightweight clipping for X/Twitter long-form articles.

English · 中文

X-TOC is a browser extension for X.com and Twitter.com long-form articles. It adds a table of contents, a floating reading panel, and a local clipping workflow for saving selected passages.

Product website · Project story

Features

• Detect headings in X/Twitter long-form articles.
• Show the current article table of contents in the popup.
• Pin a floating TOC panel while reading.
• Drag the floating panel and persist its position.
• Select article text and save it with save to xtoc.
• Review saved clips in the Options page.
• Export all or selected clips as Markdown or JSON.
• Store clip data locally with chrome.storage.local.

Install from Source

git clone https://github.com/HiAriesZhou/x-toc.git
cd x-toc
npm install
npm run build

Load the extension:

1. Open chrome://extensions/.
2. Enable Developer mode.
3. Click Load unpacked.
4. Select dist/chromium.

Development

npm run dev
npm run build
npm run build:firefox
npm run build:edge

Privacy

Saved clips are stored locally in your browser extension storage. X-TOC does not send saved clips to an external server.

Contributing

See CONTRIBUTING.md.

License

MIT. See LICENSE.