feat(pds): add pds identity command for PLC migration
#91
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
New command streamlines migration from bsky.social (or any PDS) by handling the PLC directory update: - `plc-client.ts`: modular PLC operations using @atcute/client - SourcePdsPlcClient: request token, sign operations - PlcDirectoryClient: fetch docs, submit operations - `identity.ts`: guided CLI flow with email token verification - Updates migrate.ts to show the new command in next steps - 16 tests covering client operations and error handling Migration flow is now: migrate → identity → activate 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
commit: |
Deploying with
|
| Status | Name | Latest Commit | Updated (UTC) |
|---|---|---|---|
| ✅ Deployment successful! View logs |
atproto-pds | b34d509 | Jan 11 2026, 12:42 PM |
- Mark account migration as "tested and verified" in root README - Add passkey authentication to feature list - Update packages/pds README from "Experimental" to "Beta" status - Document `pds identity` command in CLI reference - Update migration wizard plan to completed status (11 Jan 2026) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add steps 1-5 with detailed explanations for each command - Include "Full command sequence" section for quick reference - Update template README with same migration flow - Add identity, status, and passkey commands to CLI table - Update template from "Experimental" to "Beta" status 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
pds init already prompts to deploy to Cloudflare at the end of the flow, so showing a separate `pds init --production` step was misleading. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new
pds identitycommand that handles the PLC directory update during migration from another PDS (like bsky.social). This streamlines the migration flow to:pds migrate– import your datapds identity– update your DID to point to Cirruspds activate– go liveWhat it does
Architecture
plc-client.ts– modular PLC operations using@atcute/clientSourcePdsPlcClient: handles token requests and operation signing against source PDSPlcDirectoryClient: fetches documents and submits operations to plc.directoryidentity.ts– guided CLI flow with clear prompts and error handlingmigrate.tsto showpds identityin the "next steps" outputTests
16 tests covering:
Test plan
pnpm test🤖 Generated with Claude Code