Wildfire

A macOS menu bar assistant for capturing screen snippets and sending them to AI for analysis.

Overview

Wildfire is a Swift-based macOS menu bar app by Black Lambda. It lets you capture a selected region of the screen, sends the image to OpenAI, and presents the response in a lightweight desktop UI.

Features

• Menu bar access with a global snip keybind
• Screen-region capture for AI analysis
• OpenAI API configuration through environment settings
• Response display with navigation history
• Debug-oriented local development workflow

Requirements

• macOS 13 or later
• Swift 5.9 or later
• Xcode or Xcode Command Line Tools
• OpenAI API key
• Screen Recording permission for Wildfire

Installation

Clone the repository and build the executable:

git clone https://www.github.com/m-tedeschi/wildfire
cd wildfire
swift build

Create ~/.wildfire.env with your OpenAI settings:

OPENAI_API_KEY=your_api_key
OPENAI_MODEL=gpt-5.6-luna

To package Wildfire as a macOS app bundle, run:

chmod +x Scripts/package-app.sh
./Scripts/package-app.sh

The packaged app is created at .build/Wildfire.app.

Usage

Run Wildfire locally:

swift run Wildfire

Use the default keybind, Left Control + Left Option + Left Command + Backslash, to start a screen snip. Select a region, then wait for Wildfire to analyze the capture and show the response.

If macOS blocks screen capture, grant Screen Recording permission in System Settings under Privacy & Security.

Future Improvements

• Document configuration options for custom keybinds and debug mode
• Add first-run setup guidance for permissions and API configuration
• Expand response workflows beyond the current menu and history controls