at:// desktop integration
README.md
# overlat overlat shows your atproto repository as a folder of JSON files on Linux. Each record is one file. When you save a file, overlat writes the record to your PDS. When the record changes on the PDS, the file changes too. overlat is an early release. It works with one account at a time. It was tested with one account on a [Cocoon](https://github.com/haileyok/cocoon) PDS. Read "Limits" before you mount a repository with writes enabled. ## Requirements - Linux with FUSE 3 (`/dev/fuse` and `fusermount3`). - Go 1.27.4 or later, to build overlat. - A web browser to log in. ## Install ```sh go install tangled.org/matilde.at/overlat/cmd/overlat@v0.0.2 ``` ## Usage `overlat help` lists every command, flag and environment variable. This section describes the main tasks. ### Log in ```sh overlat login alice.example.com ``` overlat logs in with OAuth. overlat opens your browser at the authorization page of your PDS. After you accept, the browser returns to overlat on a local address (`127.0.0.1`), and overlat saves the session. The login asks for the scopes `atproto repo:* blob:*/*`, which let overlat change records and upload blobs. A writable mount needs `repo:*`, `transition:generic`, or a `repo:*` scope that allows both `create` and `update`. `overlat whoami` shows the saved session. If the access token expires within one minute, `whoami` refreshes the token first. `overlat status` shows the session and the local copy of the repository. ### Mount read-only ```sh mkdir -p ~/at overlat mount --read-only ~/at ``` A read-only mount reads the DID and the PDS address from the saved session, so it needs a login. The mount does not use the session's tokens: it reads only public endpoints. The first mount downloads the whole repository into a local SQLite database. Later mounts start from that copy. The mount then follows the PDS's event stream (`subscribeRepos`), so a like that you make in an app appears in the folder after about one second. overlat checks the signature of every commit against the signing …