Skyscraper

A tool for deleting old posts from Bluesky and Mastodon.

Posts older than a configurable retention period (default: 180 days) are deleted automatically. A do-not-delete list lets you exempt specific posts.

Installation

Homebrew (macOS and Linux)

brew install ZacSweers/tap/skyscraper

Shell installer (macOS and Linux)

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/ZacSweers/skyscraper/releases/latest/download/skyscraper-cli-installer.sh | sh

PowerShell installer (Windows)

powershell -ExecutionPolicy ByPass -c "irm https://github.com/ZacSweers/skyscraper/releases/latest/download/skyscraper-cli-installer.ps1 | iex"

Cargo

cargo install skyscraper-cli

GitHub Releases

Download prebuilt binaries from the latest release.

GitHub Action

Use skyscraper in your own GitHub Actions workflow without installing anything:

name: Skyscraper

on:
  schedule:
    - cron: '0 6 * * *'
  workflow_dispatch:

jobs:
  cleanup:
    runs-on: ubuntu-latest
    steps:
      - uses: ZacSweers/skyscraper@v1
        with:
          bluesky-identifier: ${{ secrets.BLUESKY_IDENTIFIER }}
          bluesky-app-password: ${{ secrets.BLUESKY_APP_PASSWORD }}
          mastodon-instance-url: ${{ secrets.MASTODON_INSTANCE_URL }}
          mastodon-access-token: ${{ secrets.MASTODON_ACCESS_TOKEN }}
          do-not-delete: |
            bluesky:3k2la5diqyc2x
            mastodon:111234567890123456
          do-not-delete-path: path/to/do-not-delete.txt

Setup

1. Generate tokens

You can run the setup-tokens.sh script in this repo to generate and configure all tokens interactively:

./setup-tokens.sh

The script walks you through each platform, validates credentials, and optionally writes them as GitHub Actions secrets via gh secret set.

If you prefer to do it manually, see Manual token setup below.

2. Configure the do-not-delete list

Edit do-not-delete.txt to protect posts from deletion. One entry per line:

# Bluesky — use the rkey (last segment of the AT URI) or the full URI
bluesky:3k2la5diqyc2x
bluesky:at://did:plc:xyz/app.bsky.feed.post/3k2la5diqyc2x

# Mastodon — use the status ID
mastodon:111234567890123456

Lines starting with # and blank lines are ignored.

Environment variables

Required (per platform)

Any platform whose variables are missing is silently skipped.

Optional

Manual token setup

Bluesky

1. Go to bsky.app → Settings → App Passwords.
2. Create a new app password (name it something like "skyscraper").
3. Set BLUESKY_IDENTIFIER to your handle and BLUESKY_APP_PASSWORD to the generated password.

Mastodon

1. Log into your instance's web UI.
2. Go to Preferences → Development → New Application.
3. Set the application name (e.g. "skyscraper").
4. Required scopes: read:accounts, read:statuses, write:statuses.
5. Save, then copy the access token.
6. Set MASTODON_INSTANCE_URL to your instance URL and MASTODON_ACCESS_TOKEN to the token.

Running locally

# Dry run (no deletions)
DRY_RUN=true BLUESKY_IDENTIFIER=you.bsky.social BLUESKY_APP_PASSWORD=xxxx cargo run

# Real run
BLUESKY_IDENTIFIER=you.bsky.social BLUESKY_APP_PASSWORD=xxxx cargo run

License

Copyright (C) 2026 Zac Sweers

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.