Releases: Bliveren/CrossGen
Release list
CrossGen v0.3.1
CrossGen v0.3.1 makes the desktop app, CLI, and AI Agent share a reliable image task runtime with durable queue execution, Gallery/History reuse, and packaged MCP integration.
Highlights
- One-stop API key configuration and model/path discovery.
- Reliable Gallery and History workflows tied to local folders.
- Lightweight image editing and reuse loops for generate, edit, save, and regenerate.
- Packaged CLI and MCP access for agent workflows.
- Dark mode and release-ready desktop packaging.
Downloads
- macOS arm64 DMG
- Windows x64 NSIS installer
- Linux x86_64 AppImage
Notes
This release is published from the approved v0.3.1 RC4 testing line.
CrossGen v0.3.1 RC 4
CrossGen v0.3.1 RC 4 is a pre-release candidate for final product-owner validation after the latest Windows CLI/MCP stdio fixes.
Source commit: 401351bf890b1ef6ced4cadd0284217e6eedb6de
Main CI: https://github.com/Bliveren/CrossGen/actions/runs/29983968135
macOS arm64 candidate package:
CrossGen-0.3.1-mac-arm64.dmgsize103952131, sha25688387884aedea0ba14c095ce775e1136c51926383b86a74a0ff40ab9f04fb808CrossGen-0.3.1-mac-arm64.zipsize99641838, sha256ed2bf5ffdc8094a3e2dfebfd536501ce963093dc38daed98934f84cf8f2ee591CrossGen-0.3.1-mac-arm64.dmg.blockmapsize109945, sha2561ab55eb141f9f94f4331f8f31a2e5839a17b8e4839bddb13cf9884de15e0c53cCrossGen-0.3.1-mac-arm64.zip.blockmapsize104476, sha256e29c2a06bd46266e2c8d3af7e23196d7ecdcd4626c2e5b2ae6f9174225e137a5
Validation completed locally on macOS arm64:
pnpm buildpassed with 39 Vitest files and 368 tests.pnpm verify:cli-mcp-smokepassed.pnpm verify:agent-integration-smokepassed.pnpm package:mac:signedpassed.pnpm verify:release:macpassed after final DMG stapling.codesign --verify --deep --strict --verbose=4 release/mac-arm64/CrossGen.apppassed.spctl --assess --type execute --verbose=4 release/mac-arm64/CrossGen.appaccepted the app as Notarized Developer ID.- Apple notarytool accepted the final DMG submission
bce9dd0b-28e2-4537-8924-237dbab5c317; the DMG was stapled and validated.
This pre-release is not Latest and does not update docs/updates/latest.json. Final v0.3.1 publication still requires hands-on product-owner acceptance of this exact installable package.
CrossGen v0.3.1 RC 3
CrossGen v0.3.1 RC 3 is a pre-release candidate for product-owner validation of the 0.3.1 release line.
Source commit: 74d6f75aecaf5bd562f5ef3160e0f38eb6afd5d2
Main CI: https://github.com/Bliveren/CrossGen/actions/runs/29912565306
macOS arm64 candidate package:
CrossGen-0.3.1-mac-arm64.dmgsize103670140, sha256e3c62dec26b5696537818230536d7d1f818ed7ee51a946433abb3da49423dba9CrossGen-0.3.1-mac-arm64.zipsize99370944, sha256e81eae8dd98eec6a8f32c4dae29c9ae74eb484005381180b64d98f056793de29CrossGen-0.3.1-mac-arm64.dmg.blockmapsize108010, sha256313ab7a0d53eb18794529ab4d9185161059add10a0010a3f5f94acd65993e048CrossGen-0.3.1-mac-arm64.zip.blockmapsize104483, sha2566d91fe7d462163681ad5650b9a02743cba0f75c7c0730ef9338713c52af0eb6f
Validation completed locally on macOS arm64:
pnpm package:mac:signedpassed after typecheck, 39 Vitest files, 366 tests, renderer build, and main build.pnpm verify:release:macpassed after final DMG stapling.codesign --verify --deep --strict --verbose=4 release/mac-arm64/CrossGen.apppassed.spctl --assess --type execute --verbose=4 release/mac-arm64/CrossGen.appaccepted the app as Notarized Developer ID.- Apple notarytool accepted the final DMG submission
03e2628d-1a15-42fc-96b4-f1145fd70f03; the DMG was stapled and validated.
This pre-release is not Latest and does not update docs/updates/latest.json. Final v0.3.1 publication still requires hands-on product-owner acceptance of this exact installable package.
CrossGen v0.3.1 RC 2
CrossGen v0.3.1 RC 2 is a pre-release candidate for final CLI/MCP and queue hardening validation.
Source commit: 6319b9d402a71dfb657920b1acf9caf7d23c1185
Merged PRs: #202 and #203
CI runs: https://github.com/Bliveren/CrossGen/actions/runs/29903686419 and https://github.com/Bliveren/CrossGen/actions/runs/29904518015
This pre-release is not Latest and does not update docs/updates/latest.json. Final v0.3.1 publication still requires hands-on product-owner acceptance of the exact installable package.
CrossGen v0.3.0
CrossGen 0.3.0 is the release where Image2Tools becomes a one-stop AI image generation manager. The focus is practical daily work: configure API access once, discover models and compatible routes, generate images, keep useful results organized, edit images quickly, then reuse them as references for the next image-to-image round.
User-Facing Highlights
- CrossGen brand and positioning: README, release messaging, and package metadata now describe CrossGen as a one-stop AI image generation manager rather than a low-level image API utility.
- One API access hub: save multiple API keys and Base URLs, switch access profiles, run model discovery, and let CrossGen use the route that works for the configured provider.
- OpenAI-compatible aggregation gate: v0.3.0 real-provider acceptance validates GPT Image 2 and Gemini image models through a compatible aggregation endpoint and the product-supported
/chat/completionsimage path. - Better Gallery and History reuse: generated outputs and saved Gallery assets can be searched, tagged, organized into folders, previewed, edited, and dragged directly into image-to-image reference slots.
- Local folder-friendly Gallery: Gallery assets remain local files, so users can manage reusable images both inside CrossGen and through their normal local file workflow.
- Simple image editing loop: preview, crop, draw, add text, pick colors, save edited results to Gallery, then reuse them immediately for another generation.
- Prompt templates and chips: prompt templates, Gallery references, and color values can be inserted into the prompt workflow without leaving the main workspace.
- Dark mode: the UI now has a calmer dark theme for longer image review and editing sessions.
- Community: feedback and workflow discussion are available through the CrossGen Discord community at https://discord.gg/XphwmYtY.
Validation
pnpm buildpnpm verify:mock-apipnpm verify:mock-gemini-apipnpm verify:mock-model-discovery- Real-provider acceptance through an OpenAI-compatible aggregation endpoint is recorded in
docs/release/evidence.json. pnpm verify:release-evidencepnpm verify:release-evidence -- --require-completepnpm package:macandpnpm verify:release:macfor the macOS arm64 packagecodesign --verify --deep --strictfor the Developer ID signed macOS app- Windows native full-install verification and Linux CI package/AppImage verification are recorded in
docs/release/evidence.json.
Release Assets
- macOS arm64 DMG is Developer ID signed and published as
CrossGen-0.3.0-mac-arm64.dmg. - Windows x64 installer is published as
CrossGen-Setup.exe. docs/updates/latest.jsoncontains the final v0.3.0 macOS and Windows asset URLs, SHA256 hashes, and byte sizes.- Apple notarization remains environment-dependent and is blocked until Apple credentials are configured.
Windows Update Hotfix
- 2026-07-13: Replaced
CrossGen-Setup.exeand its blockmap with a Windows updater hotfix build from commitfe50393. The installer SHA256 is5c7781c761888fbf9828c4947fa0be7fc330149c8fbf344912f583f7616ccd53anddocs/updates/latest.jsononmainhas been updated to match.
v0.2.4
Bugfix release for saved model configurations and Gemini image sizing.
Fixes
- Saved configurations are now unified with Model config: the saved list shows every local configuration, including the current one, so a newly saved model configuration is immediately visible and can be selected later.
- Configuration terminology is consistent: the left rail now uses "Saved configurations", "Configuration name", and "Add configuration" instead of separating model config from API access wording.
- Add configuration stays in the model configuration flow: added configurations are created, saved, selected as current, and shown in the same saved-configuration list used for switching.
- Gemini image size controls are sent through the Gemini image config field: Gemini and Gemini General requests now send
generationConfig.imageConfig.aspectRatioandimageSize, so selections such as1:1are passed to Gemini 3 Pro Image instead of being ignored.
What's Changed
- fix: prepare v0.2.4 configuration and Gemini sizing fixes by @Bliveren in #123
- release: prepare v0.2.4 by @Bliveren in #124
Full Changelog: v0.2.3...v0.2.4
v0.2.3
v0.2.3
Compatibility, release, and configuration UI patch. Disables OpenAI streaming globally for aggregator compatibility, adds the image preview context menu, and restores the multi-API configuration workflow before the final v0.2.3 package.
UI fixes
- API access is integrated into model configuration with compact active/inactive API cards and expandable details.
- Prompt templates now open from one button below the prompt input.
- Reference Gallery is consolidated into the right rail beside Recent Jobs and supports drag into the reference area.
- Removed the unclear prompt dropdowns and color-code entry below the prompt textarea.
macOS
- Attached assets:
Image2Tools-0.2.3-mac-arm64.dmg,Image2Tools-0.2.3-mac-arm64.zip, and blockmaps. - Developer ID signed with
Xiamen Corgnitor Technology Co.,Ltd (RPX587R2R7). - Not Apple-notarized in this rebuild because Apple notarization credentials were not configured in the release shell;
spctlreportsUnnotarized Developer ID. - SHA256 (DMG):
7c30c38997a37821947661f3fa61dbeb3dca5c62b9e915d0aeecdacda8b6cc74. - SHA256 (ZIP):
705753c183dce50c22cd069965de5a72fc5b8d9e515d91c5df18ca84a47a8015.
Windows
- Attached asset:
Image2Tools-Setup.exe. - SHA256:
4c3edf69da25c36c24bc168043786b407795db9130062ed0132151ba198cf586.
docs/updates/latest.json contains the final v0.2.3 asset URLs, SHA256 hashes, and byte sizes.
What's Changed
- Fix v0.2.2 Windows installer SHA256 in update manifest by @Bliveren in #117
- Disable streaming for all OpenAI jobs by @Bliveren in #118
- Fix mac release verifier DMG selection by @Bliveren in #120
- feat: add prompt chip trigger input by @Bliveren in #121
- fix: preserve gallery references safely by @Bliveren in #122
Full Changelog: v0.2.2...v0.2.3
What's Changed
- Fix v0.2.2 Windows installer SHA256 in update manifest by @Bliveren in #117
- Disable streaming for all OpenAI jobs by @Bliveren in #118
- Fix mac release verifier DMG selection by @Bliveren in #120
- feat: add prompt chip trigger input by @Bliveren in #121
- fix: preserve gallery references safely by @Bliveren in #122
Full Changelog: v0.2.2...v0.2.3
Image2Tools v0.2.2
Experience and open-source presentation release on top of v0.2.1. Real
OpenAI (gpt-image-2) and Gemini (gemini-3.1-flash-image) API acceptance has
been re-run against a cost-approved OpenAI-compatible image aggregator endpoint
(see docs/release/evidence.json).

Experience
- Result viewer reworked into a dedicated image preview: mouse-wheel zoom that
no longer scrolls the surrounding panel, double-click to open a full preview,
and drag-to-pan when zoomed in. Zoom controls move into a canvas overlay. - Provider info collapses to a compact inline chip beside the key status to
save sidebar space. - History gains newest/oldest sorting, and history result images can be dragged
into the reference area. - Drag-and-drop image files from the OS onto the reference area to import them.
Fixes
- External drag-drop upload now resolves dropped file paths through
webUtils.getPathForFileinstead of the non-standardFile.path, which
Electron 32+ removed — drag-drop import works again in packaged builds. - Windows in-app updater timeout increased from 30s to 10 minutes for large installer downloads.
- Windows in-app updater now uses PowerShell-based process exit handling to prevent NSIS installer blocking.
Open-source presentation
- README showcase now uses real product screenshots instead of placeholders.
- Added a Download & Install section with macOS Gatekeeper quarantine bypass
(xattr -dr com.apple.quarantine), Windows SmartScreen guidance, and SHA256
verification instructions againstdocs/updates/latest.json. - README header adds dynamic badges (release, CI, last commit, stars) alongside
the license/platform/stack badges. - GitHub About description and repository topics expanded for discoverability.
Install
Download the macOS dmg or Windows installer below. These are unsigned preview builds — your OS will warn on first launch (macOS Gatekeeper / Windows SmartScreen). This is expected for an unsigned open-source preview and does not mean the app is unsafe. See the Download & Install guide for one-time bypass steps. Signing & notarization are tracked in #116.
Verify your download (optional)
| Platform | File | SHA256 |
|---|---|---|
| macOS arm64 | Image2Tools-0.2.2-mac-arm64.dmg |
d4f8974ef14f86562aa7917888633cbe4dfd21f75b72d43e40469a3c159e23a0 |
| Windows x64 | Image2Tools-Setup.exe |
e25e92b6c7dbd4da2621fffd1c8db9664232b054cbd79b6ca0b06d381043db61 |
Acceptance status
Real gpt-image-2 and gemini-3.1-flash-image API acceptance passed; Windows/Linux native package gates passed; update manifest assets verified. macOS Developer ID signing/notarization is a tracked non-blocking enhancement (#116).
Important: v0.2.0 users must manually install once
The Windows in-app updater fix only applies to v0.2.2+. v0.2.0 users cannot auto-update due to the old timeout/launcher code in their installed client. Please manually download and install v0.2.2 once, then future in-app updates will work normally.
What's Changed
- Fix Windows in-app updater timeout and process blocking by @Bliveren in #114
- v0.2.2: image preview viewer, history sort + drag, drag-drop upload by @Bliveren in #115
Full Changelog: v0.2.1...v0.2.2
Image2Tools v0.2.1 (unsigned preview)
Image2Tools v0.2.1 (unsigned preview)
Bugfix and UX release based on post-0.2.0 user feedback.
Changes
- Reference-image editing and inpaint requests now run without SSE streaming, fixing aggregator/proxy failures such as
provider returned non-SSE response for streaming requeston/images/edits. - The provider dropdown has been removed. The app preserves saved configuration and relies on model discovery to infer provider/model availability.
- The workspace mode tabs are simplified to Text to image and Image to image. Masks are now optional under Image to image while internal generate/edit/inpaint routing remains intact.
- Draft restore, history reuse, Gemini guided-region wording, and General fallback behavior remain compatible with the v0.2.0 multi-model workflow.
Validation
- PR #113 CI passed: build/mock verifier, macOS package, Windows package, Linux package.
- Local release validation passed on macOS arm64:
pnpm install --frozen-lockfilepnpm buildpnpm verify:mock-apipnpm verify:mock-gemini-apipnpm verify:mock-model-discoverypnpm verify:release-evidencepnpm package:macpnpm verify:release:mac
Release Status
This is an unsigned/ad-hoc signed preview prerelease. macOS artifacts are not Apple-notarized, so Gatekeeper may warn on first launch. Real OpenAI/Gemini API acceptance and Developer ID signing/notarization remain pending in docs/release/evidence.json.
What's Changed
Full Changelog: v0.2.0...v0.2.1
What's Changed
Full Changelog: v0.2.0...v0.2.1
Image2Tools v0.2.0 (unsigned preview)
Image2Tools v0.2.0 Release Notes
Status: unsigned preview prerelease. macOS and Windows artifacts are published for evaluation. macOS builds are ad-hoc signed and not Apple-notarized, so Gatekeeper may warn on first launch (right-click > Open, or remove the quarantine attribute). Developer ID signed and notarized distribution is tracked for a future release.
Highlights
- Multi-model workspace for GPT Image 2, Nano Banana 3, and General launch flows.
- Refined left sidebar with separate model configuration, launch model, parameter configuration, draft, notice, and update areas.
- Model configuration now runs automatic connection checks on startup and after saved API config changes. The UI shows connection status beside the model configuration title and surfaces friendly failure guidance.
- Model discovery can infer provider/model availability from the configured API and enables launch families based on discovered models rather than only the selected provider label.
- OpenAI provider path keeps GPT Image 2 generation, editing, exact-mask inpainting, streaming partial previews, downloads, and history.
- GPT Image 2 multi-output generation now uses non-stream requests when count is greater than one, backfills providers that return fewer images than requested, and shows selectable final-result thumbnails in the canvas.
- Gemini provider path adds the app's Nano Banana 3 launch target for discovered Gemini image models such as
gemini-3.1-flash-imageandgemini-3-pro-image, withgenerateContentimage generation, reference-image editing, guided-region editing, and Gemini-specific controls. - Launch model buttons now include concrete discovered-model choices when multiple compatible models are available under the same launch family.
- General launch mode is a minimal fallback for discovered non-focused image models. Gemini General supports prompt and reference images; OpenAI and Custom General use a prompt-only OpenAI-compatible
/images/generationscontract. - History entries now retain provider/model context so reused prompts restore the matching launch model and parameters.
- Clearing all recent-task history now requires explicit confirmation.
- Update checks now default to the raw GitHub manifest URL to avoid the previous GitHub Pages 404. The sidebar shows an automatic up-to-date status, saves the current draft before update launch, and starts the Windows NSIS installer in silent mode with app restart after installation.
Verification Gates
Before publishing v0.2.0, run:
pnpm build
pnpm verify:mock-api
pnpm verify:mock-gemini-api
pnpm verify:mock-model-discoveryOpenAI real API acceptance is cost-gated through:
IMAGE2TOOLS_API_KEY=sk-... IMAGE2TOOLS_REAL_API_ACCEPT_COST=1 pnpm verify:real-apiGemini / Nano Banana 3 real API acceptance is cost-gated through:
IMAGE2TOOLS_GEMINI_API_KEY=... IMAGE2TOOLS_REAL_GEMINI_API_ACCEPT_COST=1 pnpm verify:real-gemini-apiThe verifier covers discovery, generation, reference editing, and guided-region editing. Do not mark Gemini real acceptance complete until the verifier and app-level history/download checks pass with a real Gemini key.
Release package verification remains platform-specific:
pnpm verify:release:mac
pnpm verify:release:windows
pnpm verify:release:linuxRe-run the secret scan in SECURITY.md after every release-note or packaging metadata update.
The app package metadata is 0.2.0. For this unsigned preview, docs/updates/latest.json
publishes the darwin (arm64 dmg) and win32 (x64 installer) assets with verified URL,
sha256, and sizeBytes metadata generated from the exact uploaded artifacts. When
Developer ID signed and notarized macOS artifacts become available, regenerate the
manifest from the signed build and supersede this preview.
What's Changed
- Document multi-model v0.2 plan by @Bliveren in #71
- Stabilize Windows silent installer verification by @Bliveren in #75
- Add multi-model contracts and state migration by @Bliveren in #73
- Add Gemini image mock verifier by @Bliveren in #72
- Add expandable model-aware history panel by @Bliveren in #74
- Update multi-model progress checklist by @Bliveren in #76
- Extract OpenAI image provider adapter by @Bliveren in #77
- docs: update multi-model phase 3 progress by @Bliveren in #78
- Add Gemini image adapter runtime by @Bliveren in #80
- Add model discovery UI slice by @Bliveren in #79
- docs: update multi-model phase 2 and 4 progress by @Bliveren in #81
- Add Gemini renderer parameter controls by @Bliveren in #82
- docs: update Nano UI progress by @Bliveren in #83
- Add General fallback mode by @Bliveren in #84
- docs: update General fallback progress by @Bliveren in #85
- Add mock model discovery verifier by @Bliveren in #86
- docs: update multi-model release security docs by @Bliveren in #87
- Add renderer multi-model smoke tests by @Bliveren in #88
- Add provider-aware General fallback by @Bliveren in #89
- docs: sync multi-model smoke evidence by @Bliveren in #90
- docs: sync final General fallback status by @Bliveren in #91
- Add real Gemini API verifier by @Bliveren in #92
- Require explicit Gemini real API cost gate by @Bliveren in #93
- Add renderer UI acceptance smoke coverage by @Bliveren in #94
- Stage v0.2.0 release metadata by @Bliveren in #95
- Require update manifest asset sizes by @Bliveren in #96
- Add update manifest asset helper by @Bliveren in #97
- Add release evidence validation by @Bliveren in #98
- Guard release checklist evidence alignment by @Bliveren in #99
- Refresh completion audit for v0.2.0 by @Bliveren in #100
- Refresh multi-model plan status by @Bliveren in #101
- Link release evidence gates to trackers by @Bliveren in #104
- Clarify v0.2.0 release blockers by @Bliveren in #105
- Record Windows full-install evidence by @Bliveren in #106
- Record Windows native release completion by @Bliveren in #107
- Enable capability-based model launches by @Bliveren in #108
- Add model variants and robust Gemini image parsing by @Bliveren in #109
- Parse Gemini text data URL images by @Bliveren in #110
- Refine sidebar settings workflow by @Bliveren in #111
- Refresh README and release notes by @Bliveren in #112
Full Changelog: v0.1.0...v0.2.0