Something went wrong. Try again.
at:// desktop integration
Something went wrong. Try again.
Files
- Go 100%
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 …