pdsx CLI

Use uvx pdsx (or uv run pdsx for local dev) for ATProto record operations.

Authentication

Reads don't need auth, just -r/--repo. Writes need --handle and --password:

bash
1# reads - no auth
2uvx pdsx -r someone.bsky.social ls app.bsky.feed.post
3
4# writes - auth required
5uvx pdsx --handle you.bsky.social --password xxxx-xxxx create app.bsky.feed.post text='hello'

You can also set env vars: ATPROTO_HANDLE, ATPROTO_PASSWORD

Commands

Examples

bash
1# list posts from someone
2uvx pdsx -r zzstoatzz.io ls app.bsky.feed.post
3
4# get a specific post
5uvx pdsx get at://did:plc:xxx/app.bsky.feed.post/abc123
6
7# get someone's profile
8uvx pdsx -r zzstoatzz.io get app.bsky.actor.profile/self
9
10# create a post
11uvx pdsx --handle you.bsky.social --password $APP_PASSWORD create app.bsky.feed.post text='hello from pdsx'
12
13# check who you're authenticated as
14uvx pdsx --handle you.bsky.social --password $APP_PASSWORD whoami
15
16# delete a post
17uvx pdsx --handle you.bsky.social --password $APP_PASSWORD rm at://did:plc:xxx/app.bsky.feed.post/abc123

Batch Operations

Pipe JSONL to stdin for batch operations:

bash
1# batch create
2echo '{"text":"post 1"}
3{"text":"post 2"}' | uvx pdsx --handle ... create app.bsky.feed.post
4
5# batch delete
6echo 'at://did:plc:xxx/app.bsky.feed.post/abc123
7at://did:plc:xxx/app.bsky.feed.post/def456' | uvx pdsx --handle ... rm
8
9# batch update (JSONL with uri field)
10echo '{"uri":"at://...","text":"updated text"}' | uvx pdsx --handle ... update

Output Formats

Use -o/--output for different formats:

bash
1uvx pdsx -r someone.bsky.social ls app.bsky.feed.post -o json
2uvx pdsx -r someone.bsky.social ls app.bsky.feed.post -o yaml
3uvx pdsx -r someone.bsky.social ls app.bsky.feed.post -o table
4uvx pdsx -r someone.bsky.social ls app.bsky.feed.post -o compact  # default for list

Common Collections