Cross post to all socials at once from your terminal

Supported Socials

• X/Twitter
• Mastodon
• BlueSky

Getting Started

Install

Via homebrew

brew install blacktop/tap/xpost

Via Golang

go install github.com/blacktop/xpost@latest

Or download the latest release

Configuration

Set environment variables for the platforms you want to use:

Twitter/X

export XPOST_TWITTER_CONSUMER_KEY="your_key"
export XPOST_TWITTER_CONSUMER_SECRET="your_secret"
export XPOST_TWITTER_ACCESS_TOKEN="your_token"
export XPOST_TWITTER_ACCESS_TOKEN_SECRET="your_token_secret"

Mastodon

export XPOST_MASTODON_SERVER="https://mastodon.social"
export XPOST_MASTODON_ACCESS_TOKEN="your_token"
export XPOST_MASTODON_CLIENT_ID="your_client_id"
export XPOST_MASTODON_CLIENT_SECRET="your_client_secret"

BlueSky

export XPOST_BLUESKY_HANDLE="your.handle"
export XPOST_BLUESKY_APP_PASSWORD="your_app_password"

Usage

Send message to all supported networks

❱ xpost -m test --image docs/logo.webp
Posted to  Bluesky
Posted to  Mastodon
Posted to  Twitter/X

License

MIT Copyright (c) 2025 blacktop