Free, open-source desktop app for AI-powered social publishing. Available for macOS, Windows, and Linux.
sudo codesign --force --deep --sign - /Applications/GhostPilot.app —
then open normally. See
setup steps below.
chmod +x GhostPilot-1.0.5.AppImage && ./GhostPilot-1.0.5.AppImage.
Requires libsecret for keychain (apt install libsecret-1-0
on Debian/Ubuntu).
.dmg
file, drag GhostPilot to
/Applications.
This is a one-time step. The
codesign
command applies a local ad-hoc signature that satisfies macOS's requirement without
needing an Apple Developer certificate.
GhostPilot-1.0.5-setup.exe.
libsecret
for OS keychain. Install it with:
sudo apt install libsecret-1-0
(Debian/Ubuntu) before first launch.
| File | Type | What it does |
|---|---|---|
| GhostPilot-1.0.5-arm64.dmg | Install | macOS disk image for Apple Silicon (M1/M2/M3/M4). Drag app to /Applications to install. |
| GhostPilot-1.0.5-x64.dmg | Install | macOS disk image for Intel Macs. Same UX as arm64 — just a different native binary. |
| GhostPilot-1.0.5-setup.exe | Install | Windows NSIS installer. Adds Start Menu shortcut, desktop icon, and uninstaller to Programs & Features. |
| GhostPilot-1.0.5-portable.exe | Install | Windows portable build. No installation required — just double-click and run. Stores user data next to the exe. |
| GhostPilot-1.0.5.AppImage | Install | Linux universal package. Self-contained — runs on any x64 distro with glibc 2.28+ without installing anything. |
| GhostPilot-1.0.5-amd64.deb | Install |
Debian/Ubuntu package. Install with
dpkg -i
or double-click in a file manager. Registers in package manager for clean
uninstall.
|
| GhostPilot-1.0.5-arm64.dmg.blockmap | Update | Delta patch map for the macOS arm64 DMG. Used by the built-in auto-updater to download only the bytes that changed — not the full file. |
| GhostPilot-1.0.5-x64.dmg.blockmap | Update | Same as above, for macOS Intel. The auto-updater downloads this to compute a diff against your installed version. |
| GhostPilot-1.0.5-setup.exe.blockmap | Update | Delta patch map for the Windows installer. Enables partial downloads when auto-updating on Windows. |
| latest-mac.yml | electron-updater manifest for macOS. Lists the current version, release date, file names, sizes, and SHA-512 checksums. The app reads this to detect new versions. | |
| latest.yml | electron-updater manifest for Windows. Same structure as latest-mac.yml — the app polls this URL to check for updates. | |
| latest-linux.yml | electron-updater manifest for Linux. Used by AppImage builds for auto-update support. | |
| Source code (.zip) | GitHub auto-generated archive of the full repository at the v1.0.5 tag. For auditing, building from source, or forking. | |
| Source code (.tar.gz) | Same repository snapshot in gzip tar format. Preferred on Linux/macOS for building from source. |
These are the files you actually download and run. Each is a native package for its
platform. The .dmg is a macOS disk image, the .exe is a
Windows installer, the .AppImage is a self-contained Linux executable,
and the .deb is a Debian package.
A .blockmap file is a delta-update index — a map of the installer split
into fixed-size blocks with checksums. When a new version comes out, the built-in
auto-updater compares your installed version's blocks against the new release's
blockmap and downloads only the changed blocks, not the entire file.
This saves bandwidth for incremental updates.
These YAML files are read by electron-updater inside the running app.
They declare the current version, file names, download sizes, and SHA-512 hashes for
integrity verification. The app periodically fetches these manifests from GitHub
Releases to detect whether an update is available. You do not need to download them
manually.
| Platform | OS Version | Architecture | Runtime | Notes |
|---|---|---|---|---|
| macOS | 13 Ventura or later | arm64 (M1+) · x64 (Intel) | Electron 39 — bundled | Two separate DMGs — download the one matching your chip |
| Windows | 10 build 19041+ · Windows 11 | x64 | Electron 39 — bundled | ARM64 Windows not yet supported |
| Linux | Any (glibc 2.28+) | x64 (amd64) | Electron 39 — bundled |
Requires
libsecret
for OS keychain
|
Node.js and Electron are bundled — you do not need to install them separately. The app works fully offline after setup.
Reading additional input from stdin...
failure.
EADDRINUSE if a
previous OAuth session left the port open. The fallback server now waits for the
previous instance to fully close before binding, with an error handler to prevent
unhandled exceptions.
file:// URIs were
blocked by Electron's Content Security Policy in dev mode. Images are now served as
base64 data URLs from the main process — works in all environments with no CSP
changes.
dall-e-3 model to
gpt-image-1 with
quality: high for
significantly sharper output.
CreditsDepleted,
401, and
403 API errors are now
immediately marked permanent (no retry), rather than retrying every 5 minutes until
max attempts.
CSC_LINK no longer
crashes the build when Apple certificates are not configured
.ico format as required
by NSIS (was incorrectly set to PNG)
macos-13 (Intel, scarce
queue) to
macos-latest arm64 with
cross-compilation — eliminates stuck builds
charLimit, RATE_LABEL,
_API_V1) to fix all
TS6133 typecheck errors
LogProcess type
— valid values are
main | renderer | worker:*