# OpenHands ships v1.40.0 with Codex auth guidance and a git branch fix

published: 2026-11-12T17:05:34.342Z
topic: frameworks
source: https://github.com/OpenHands/OpenHands/releases/tag/v1.40.0
url: https://aiagentnews.io/stories/openhands-ships-v1-40-0-with-codex-auth-guidance-and-a-git-branch-fix

OpenHands has released v1.40.0, with clearer guidance for Codex subscription authentication and several chat and git fixes. The release notes also cover a macOS Gatekeeper workaround for builds that are not yet signed with an Apple Developer ID.

The release improves the guidance shown for authenticating a Codex subscription, which is the main feature change in the changelog. A git fix changes how the project chooses a branch: it now reads a repository's real default branch instead of assuming main. Several dependencies were also updated.

Chat behavior changed in a few places. Messages stay put at tied history page boundaries, and delayed echoes no longer delete newer drafts. The home model picker now activates when a self-hosted instance turns Agent Profiles off. Indonesian translations for the Codex subscription keys were added.

The macOS app is not yet signed with an Apple Developer ID, so macOS may report a downloaded build as damaged. The changelog attributes this to Gatekeeper quarantine rather than a bad file. After moving the app to Applications, users can clear the flag once with xattr -dr com.apple.quarantine on the app bundle. Signing and notarization are tracked in issue 16774.

## Why it matters if you build agents

Teams running OpenHands on a self-hosted instance or relying on git-based workflows should check the branch and model-picker changes in this release. Developers distributing or testing the macOS build should expect the quarantine warning until signing ships, and can use the documented command to clear it.