Forge Desktop 0.3.4 Preview 1

Forge Desktop 0.3.4 Preview 1

This is an unsigned, non-notarized macOS desktop preview built from commit 8c3bd9103b7b18e1713e674719d07ee52bb7e398.

Downloads

• forge-desktop-0.3.4-arm64.dmg / .zip: Apple Silicon Macs.
• forge-desktop-0.3.4-x64.dmg / .zip: Intel Macs; Apple Silicon users can use this through Rosetta when needed.
• SHA256SUMS: checksums for all four installers.

Verified for this build

• CI=true pnpm check
• CI=true pnpm check:docs
• CI=true pnpm eval:deterministic — 13 files, 71 tests
• CI=true pnpm desktop:build
• CI=true pnpm desktop:package
• SHA-256 checksums verified locally for all four installers.
• Both packaged executable targets were inspected: arm64 and x86_64.

The current controlled macOS environment blocked both LaunchServices installation and direct packaged-app startup with sandbox_extension_issue_file / Operation not permitted while launching the Electron Helper resources. Therefore this preview does not claim a current installed-app acceptance pass. No model call, provider login, or upload was performed as part of the smoke attempt.

Installation

1. Download the installer matching your Mac architecture.
2. Optionally verify it with shasum -a 256 -c SHA256SUMS.
3. Open the DMG and copy Forge Desktop to Applications, or unpack the ZIP.
4. Because this build is unsigned and not notarized, macOS may require using Open from the Finder context menu or allowing it under System Settings > Privacy & Security.

Preview limitations

• No Developer ID signing, notarization, or auto-updater is included.
• This tag is desktop-0.3.4-preview.1, not a v* stable release tag; it does not publish npm packages.
• Intel hardware, macOS 13, and live provider/authentication behavior are not claimed by this preview.
• Treat the binary as an evaluation build and do not use it for sensitive data without reviewing the source and permissions.

Forge v0.3.4

Forge v0.3.4 makes file editing more reliable, keeps context compaction under
explicit user control, and strengthens the interactive terminal lifecycle.

Highlights

• Unified model-facing file creation, patching, and rewriting behind
  edit_file, with operation-specific contracts and approval previews.
• Added content-hash guards so stale edits cannot silently overwrite concurrent
  user changes; create never overwrites and rewrite never creates.
• Kept legacy v0.3.3 tool exchanges readable during resume while advertising
  only the current edit_file contract to new model requests.
• Split the interactive CLI into focused activity, approval, context,
  lifecycle, prompt, provider, resource, transcript, and type modules while
  preserving the public facade.
• Renamed context modes to Manual and Automatic. Manual remains the permanent
  default; Automatic is an explicit session or saved user opt-in.
• Added one-time migration from v0.3.3 warn/compact configuration and
  pressure records to canonical manual/automatic names.
• Fixed terminal listener cleanup across repeated render, exit, and resume
  cycles, with regression tests and a real Ghostty smoke.

Install

Forge requires Node.js 24 or later.

npm install --global @jslee124/forge@0.3.4
forge --version

Existing configuration and session history migrate conservatively. Automatic
compaction is not enabled during upgrade.

Verification

The exact implementation candidate passed the full offline matrix: 360 tests,
71 deterministic evaluation checks, documentation validation, clean package
installation, and a real Ghostty exit/resume smoke. See the
v0.3.4 Milestone 15 release gates.

The authorized DeepSeek trials were development evidence rather than
exact-release-commit evidence. Native OpenAI API behavior was not live-tested
for this release, and live model quality is not inferred from deterministic
fixtures.

Full Changelog: v0.3.3...v0.3.4

Forge v0.3.3

Forge v0.3.3 focuses on long-session reliability, faithful resume behavior,
safer approvals, and clearer terminal feedback.

Highlights

• Added context-pressure reporting, explicit compaction controls, prompt-cache
  observability, and memory-only scoped session approvals.
• Replaced text-only resume reconstruction with provider-neutral canonical
  conversation history while keeping completed tool calls and results paired.
• Added session schema v3, checkpoint v2 validation, conservative migration,
  and cross-layer resume contract tests.
• Prevented oversized snapshots from replacing the previous durable snapshot
  and preserved safety context when cancellation follows a tool side effect.
• Hardened destructive-command classification across absolute paths and common
  shell or interpreter wrappers.
• Improved approval previews, semantic file diffs, visible edit activity, and
  descriptor-driven unavailable choices.
• Added versioned documentation roles and clean-installed checks for packaged
  documentation and built-in Skills.

Install

Forge requires Node.js 24 or later.

npm install --global @jslee124/forge@0.3.3
forge --version

Existing text-only sessions migrate conservatively. Historical tool output
never restores approval, policy, trust, process, or continuation authority.
Context compaction remains opt-in and defaults to warn.

Verification

The deterministic post-fix matrix, dependency audit, clean package install, and
bounded live-provider resume evidence are recorded in the
v0.3.3 release report.

The live smoke covered native DeepSeek and Luna Codex Engine through a ChatGPT
subscription. Native OpenAI API behavior was not part of that smoke. Prompt
cache hit rates and live task quality are not inferred from deterministic
fixtures.

Full Changelog: v0.3.2...v0.3.3

Forge v0.3.2

Forge v0.3.2 is a focused packaging hotfix for resource discovery in the
installed npm CLI.

Highlights

• Fixed bundled Skill and documentation asset roots after package generation.
• Restored installed-package resource discovery without publishing private
  workspace packages.
• Kept the public artifact limited to the bundled @jslee124/forge CLI.

Install

Forge requires Node.js 24 or later.

npm install --global @jslee124/forge@0.3.2
forge --version

Verification

The release workflow inspected and clean-installed the generated npm package,
then verified CLI version, help, configuration validation, bundled Skills, and
packaged documentation before publication.

Full Changelog: v0.3.1...v0.3.2

Forge v0.3.1

Forge v0.3.1 makes bundled product documentation and Skills discoverable from
the installed CLI, with versioned resource metadata and safer loading limits.

Highlights

• Added a searchable Skill catalog and on-demand Skill loading.
• Added versioned discovery for built-in Skills and packaged current-product
  documentation.
• Added bounded reference and template loading with explicit resource metadata.
• Kept historical and development-only documents outside the installed product
  help catalog.

Install

Forge requires Node.js 24 or later.

npm install --global @jslee124/forge@0.3.1
forge --version

Verification

The release workflow checked the source, documentation, complete test suite,
deterministic evaluation, generated package contents, clean installation, CLI
smoke behavior, and tag-to-package version alignment before npm publication.

Private @forge/* implementation packages and the plugin SDK remain private.

Full Changelog: v0.3.0...v0.3.1

Forge v0.3.0

Forge v0.3.0 is the first stable Forge release distributed through npm. It
keeps the implementation monorepo private while providing one bundled,
installable CLI.

Highlights

• Added explicit npm update checks and user-requested updates without automatic
  background installation.
• Added bounded, host-managed plugin subagents that continue to use Forge-owned
  credentials, policy, budgets, and traces.
• Added MCP stdio, to-do, and read-only code-review subagent examples.
• Expanded English and Simplified Chinese documentation for installation,
  configuration, security, troubleshooting, and releases.

Install

Forge requires Node.js 24 or later.

npm install --global @jslee124/forge@0.3.0
forge --version

Verification

The tagged source passed source, documentation, test, deterministic evaluation,
package inspection, clean-install, CLI smoke, and version-alignment gates before
npm publication. See the
full v0.3.0 release record.

Model behavior remains nondeterministic; the release gates verify the tested
runtime and packaging contracts, not success on every live-provider task.

Full Changelog: b969257...v0.3.0