tidy-up refactor, add readme

README.md

@@ -0,0 +1,39 @@
+# migratesky 🦋
+handy tools for migrating your bluesky account to a new DID!
+
+## build
+```sh
+go build -o migratesky .
+```
+
+## usage
+```sh
+migratesky <-from <identifier>> <-frompass <password>> <-to <identifier>> <-topass <identifier>> <-pds <pds-url>> [collections...]`
+```
+
+### example
+```sh
+# migrate the profile, follows, and preferences from @old.example.org to @new.example.org:
+migratesky -from old.example.org -frompass $SRC_PASSWORD \
+    -to new.example.org -topass $DEST_PASSWORD \
+    -pds https://my.awesome.pds.example.org \
+    profile follows preferences
+```
+
+### required arguments:
+- `-from <identifier>`: the source account handle or DID.
+- `-frompass <password>`: the source account password.
+- `-to <identifier>`: the destination account handle or DID.
+- `-topass <password>`: the destination account password.
+- `-pds <pds-url>`: the full https:// url of the destination account's PDS.
+
+### collections:
+- `profile`: imports account profile, including avatar, banner, display name, and description.
+- `follows`: imports all following accounts.
+- `preferences`: imports account preferences; including feeds, labeller settings, and content filters.
+
+### optional arguments:
+- `-frompds <pds-url>`: the source account's PDS url (defaults to the value of -pds).
+- `-dryrun`: does not import follow records; good for sanity testing!
+- `-v`: verbose output
+- `-help`: shows this help message.