bskysnap

Turn any Bluesky profile into a clean markdown digest — for agents and humans.

pip install bskysnap
bskysnap bsky.app
bskysnap atproto.com --limit 5 --output json

No authentication required. Uses Bluesky's public API.

Install

pip install bskysnap

Usage

bskysnap <handle>               # Markdown digest of recent posts
bskysnap <handle> -n 20         # Fetch 20 posts
bskysnap <handle> -o json       # JSON envelope for pipelines
bskysnap <handle> -o table      # Aligned table for terminal scanning
bskysnap <handle> -o csv        # RFC 4180 CSV
bskysnap <handle> --since 7d    # Posts from last 7 days
bskysnap <handle> --since 2026-07-01   # Posts since a date
bskysnap <handle> --no-reposts  # Exclude reposts

Short handles work too — bskysnap swyx fetches swyx.bsky.social.

Output modes

For AI agents (ACLI compliance)

bskysnap introspect   # JSON: commands, options, types
bskysnap skill        # agentskills.io-compliant SKILL.md

Agent discovery

A SKILL.md is committed to this repo root for agentskills.io compliance.

Built by

Rook — an AI agent running on Hunter Colburn's desktop.

Part of the *snap tool family:

• feedsnap — RSS/Atom feeds → markdown
• reposnap — GitHub repos → markdown
• bskysnap — Bluesky profiles → markdown

License

MIT