The bridge between your macOS screenshots and remote AI workflows.
SS Bridge is a lightweight macOS menu bar application designed to automate the capture and sharing of visual context. It captures screenshots, uploads them to your preferred cloud storage (S3, R2, Google Drive, or Dropbox), and immediately puts a shareable URL in your clipboard—perfect for sharing UI bugs or design mockups with remote AI agents like Claude or Codex.
In modern AI-assisted development, you often need to share visual context (like UI bugs, design mockups, or terminal outputs) with remote agents or team members. SS Bridge automates this process:
- Capture: Hit a hotkey (
Shift+Cmd+S). - Upload: Automatically sent to Cloudflare R2, AWS S3, Backblaze B2, Google Drive, or Dropbox.
- Share: A presigned or shared link is copied to your clipboard instantly.
The streamlined menu bar window gives you one-click access to capture screenshots, view your latest share URL, and monitor your upload history. It also provides quick status checks for permissions and credentials.
Configure multiple backends (Cloudflare R2, Amazon S3, Backblaze B2, Google Drive, and Dropbox) with provider-specific settings. Manage your credentials securely in the macOS Keychain and customize automation like "Launch at Login."
- Multi-Backend Support: Works with Cloudflare R2 (recommended), AWS S3, Backblaze B2, Google Drive, and Dropbox.
- Privacy First: Uses presigned URLs for S3-compatible backends—your bucket stays private.
- Native Integration: Built with SwiftUI for a modern macOS look and feel.
- Global Hotkey: Quick capture with a customizable system-wide shortcut.
- Launch at Login: Option to start automatically when you log in.
- Secure: Credentials are stored in the macOS Keychain.
| Backend | Link Type | Recommended For |
|---|---|---|
| Cloudflare R2 | Presigned URL | Best value (No egress fees) |
| Amazon S3 | Presigned URL | Enterprise workflows |
| Backblaze B2 | Presigned URL | Cost-effective storage |
| Google Drive | Share Link | Personal use |
| Dropbox | Share Link | Personal use |
- macOS 13.0 or later
- Xcode 15+ (for building from source)
# 1. Clone the repository
git clone https://github.com/zuhabul/ss-bridge.git
cd ss-bridge
# 2. Build and run the app
./scripts/run-app.shThe application will be built and launched. You can find the .app bundle in the dist/ directory.
- Launch the app.
- Click the 📸 icon in your menu bar and select Settings.
- Choose your provider and enter the required credentials.
- For S3/R2/B2: You'll need an Access Key, Secret Key, Bucket Name, and Endpoint.
- For Google Drive/Dropbox: Follow the OAuth flow to get an access token.
Tip
For S3-compatible providers, you can quickly configure via CLI:
export SSB_AWS_ACCESS_KEY_ID="YOUR_ACCESS_KEY"
export SSB_AWS_SECRET_ACCESS_KEY="YOUR_SECRET_KEY"
./scripts/configure-app.shSee what's planned for future releases in our Roadmap.
Contributions are welcome! Please see CONTRIBUTING.md for guidelines. When opening an issue or pull request, please use the provided templates.
If you discover a security vulnerability, please refer to our Security Policy.
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by zuhabul for the AI-assisted development community.