Smaug

Smaug is a developer tool for archiving Twitter (X) bookmarks — and optionally likes — into markdown files in an automated way, offering a simple means of preserving social media content in human-readable, version-controlled text. Named after the treasure-hoarding dragon, it uses the Twitter API (or community tools like the bird CLI) to fetch bookmarked posts and outputs them in markdown, making it easy to back up content for future reference or documentation. Smaug is designed for automation and integration into personal workflows, allowing users to run setup and export jobs from the command line with minimal configuration. It supports configuration through JSON and can be extended or scripted as part of broader personal knowledge management systems. Because the output is plain markdown, it fits well with static site generators and digital gardens — preserving links, text, and metadata in a format that’s both platform-independent and version-friendly.