OpenHands

Summary

OpenHands is an open-source AI coding agent framework, released under the MIT license (with a source-available enterprise directory that requires a paid license after a month of use), that runs coding agents against real repositories and tasks. You can run it several ways: a single command starts its Agent Canvas web UI and backend locally, a Python SDK lets you define and run agents yourself or scale them to many instances in the cloud, and a hosted OpenHands Cloud or self-hosted Enterprise option adds GitHub, GitLab, Slack, and Jira integrations with multi-user permissions. It targets software engineering teams looking to automate everyday development work, from decomposing GitHub issues into tasks to running sub-agent delegation across specialized child agents. First committed in 2024, it now has 592 contributors and a release this week, suggesting active, well-supported development.

OpenHands: AI-Driven Development

Command line

Values are placeholders taken from each option’s declared default. Nothing is executed here — the output shown is a recording of a run that already happened.

Release history

1. docs update Aug 29, 2026 · issue 010

   OpenHands automation runs now expose a live phase field and support Git sync for automations.

   
   • ›Automation runs now surface a live phase field reflecting the run's current state, visible on automation cards, in the Activity Log, and on the home screen, updating in real time as a run progresses (a failed run retains its last phase).
   • ›Adds Git sync support for automations.
   • ›Exports now include the run's phase field alongside cost, with unavailable costs exported as a defined placeholder value.
2. docs update Aug 29, 2026 · issue 010

   OpenHands adds a Getting Started checklist and a searchable LLM provider selector to the setup wizard.

   
   └──▷ HOW TO FIND IT
   Restore the Getting Started checklist after dismissing it, so new team members can follow the onboarding flow.
   📍In the console, go to Settings › Application and enable the 'Show getting started checklist' switch.
   • ›Adds a 'Getting Started' checklist in the sidebar after setup wizard completion, tracking first-use actions (set up LLM, connect MCP servers, start a conversation, explore automations, customize agent, review settings), with auto-hide when all items are complete.
   • ›Adds Show getting started checklist toggle in Settings > Application to show or hide the checklist; setting persists across sessions.
   • ›Changes the OpenHands provider connection field from free text to a searchable supported-provider selector when adding an LLM provider.
   • ›Sets OpenAI GPT-5.6 Sol as the default model and DeepSeek V4 Flash as the free OpenHands-routed model.
3. docs update Aug 29, 2026 · issue 010

   OpenHands Agent Canvas ships early-preview desktop apps for macOS, Windows, and Linux (AppImage and .deb formats).

   └──▷ TRY IT
   Install the Agent Canvas desktop app on a Debian/Ubuntu system to run OpenHands locally without a browser.
   copy

   $ sudo apt install ./Agent-Canvas-<version>.deb

   Run the Agent Canvas AppImage on a Linux system that does not use apt, without installation.
   copy

   $ chmod +x Agent-Canvas-<version>.AppImage && ./Agent-Canvas-<version>.AppImage

   • ›Adds native desktop app distribution for Agent Canvas on Linux as Agent-Canvas-<version>.AppImage (run after marking executable) and Agent-Canvas-<version>.deb (install via sudo apt install ./Agent-Canvas-<version>.deb), with macOS and Windows builds also available as early preview.
4. docs update Aug 28, 2026 · issue 009

   OpenHands prebuilt automations now support script bundles and multi-repo monitoring in a single automation.

   └──▷ HOW TO FIND IT
   When setting up a catalog automation that monitors multiple repos, enter all target repositories in the single repository field so one automation covers your entire org.
   📍In the Agent Canvas, open Prebuilt Automations › select a catalog entry that accepts repositories › fill in the repository field with multiple repositories › complete the remaining required fields and install.
   • ›Adds script bundle support to catalog entries — a packaged set of files that installs as a deterministic automation, running its own logic for polling, deduplication, and fixed API calls, with the agent invoked only for judgment-required steps.
   • ›Catalog entries that accept repositories can now collect multiple repositories in a single field, letting one automation monitor several repos at once.
5. docs update Aug 28, 2026 · issue 009

   OpenHands Agent Canvas gains Git Sync: bidirectional automation versioning via a private Git repo with optional file encryption.

   └──▷ HOW TO FIND IT
   Set up automatic Git Sync every 5 minutes to a private GitHub repo so automation changes are versioned and backed off-host continuously.
   📍In Agent Canvas, open the Automate view › select Git Sync › set Repository URL to 'https://github.com/example/automation-backup.git', Branch to 'main', Path to 'automations', Sync every (seconds) to '300', enter your HTTPS access token, then turn on Enable Git Sync and select Save and sync now.
   Review an automation change safely before it is applied by merging a PR into the synchronized branch and then triggering an immediate import.
   📍In Agent Canvas, open the Automate view › select Git Sync › select Sync now after merging your pull request into 'main', then open the affected automation and confirm the imported configuration before running it.
   Enable file-level encryption so sensitive prompts and scripts are stored as ciphertext in Git rather than readable YAML.
   📍In Agent Canvas, open the Automate view › select Git Sync › enter a strong value in the encryption key field › turn on Enable Git Sync › select Save and sync now. Store the key in a password manager — without it, encrypted files cannot be decrypted.
   • ›Adds Repository URL, Branch, Path, Access token, Sync every (seconds), commit author name/email, and encryption key fields to the Git Sync configuration panel in the Automate view.
   • ›Adds Enable Git Sync toggle and Save and sync now action to activate bidirectional sync between an Agent Canvas Automation Server and a configured Git repository branch.
   • ›Stores each automation under its own directory (e.g. automations/daily-code-review/) with an automation.yaml file and a tarball/ subdirectory so Git shows meaningful diffs for uploaded bundles.
   • ›Adds a Sync now button to trigger an immediate sync cycle without waiting for the automatic interval; concurrent cycles are deduplicated.
   • ›Adds optional file-level encryption: when an encryption key is set, automation files are committed as ciphertext rather than readable YAML, protecting sensitive prompts and scripts at rest in Git.
   +3 moreshow less

   • ›Adds a Sync Status section that displays the latest commit, last sync time, pending local changes, and any Git error after each cycle.
   • ›Supports a pull-request-based review workflow: changes merged into the synchronized branch are imported on the next cycle, while pending local changes take precedence over incoming Git changes for that cycle.
   • ›Git Sync is available only for local (non-cloud) Agent Canvas backends; cloud backends are explicitly unsupported.
6. docs update Aug 28, 2026 · issue 009

   OpenHands adds a Getting Started checklist with progress tracking and a persistent visibility toggle in Settings.

   
   └──▷ HOW TO FIND IT
   Restore the Getting Started checklist after it has been dismissed or auto-hidden.
   📍In the OpenHands UI, go to Settings › Application and enable the 'Show getting started checklist' switch.
   • ›Adds a 'Getting Started' checklist in the sidebar after setup wizard completion, guiding users through LLM setup, MCP server connection, starting a conversation, exploring automations, and customizing the agent — each item linking directly to its relevant page.
   • ›Checklist tracks completion progress, auto-hides when all items are done, and can be toggled via Show getting started checklist switch under Settings > Application, with the preference persisting across sessions.
7. v1.16.0 Aug 27, 2026 · issue 009

   OpenHands v1.16.0 adds Canvas Extensions, a Linux desktop installer, LLM-provider selection, a skills allow-list, and live automation phase visibility.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v1.16.0 https://github.com/OpenHands/OpenHands.git
   # already have the repo? check out this version:
   $ git checkout v1.16.0

   • ›Adds Canvas Extensions frontend: load pages, configure the sidebar, and customize the canvas surface.
   • ›Adds a Linux desktop installer build (.deb package) via updated CI and maintainer scripts.
   • ›Adds an LLM-switching toggle in Agent settings, letting users change the active model without leaving the agent configuration screen.
   • ›Adds LLM provider selection in Settings, restricting the UI to only supported providers.
   • ›Replaces the all-on skill catalog with an explicit allow-list, giving operators fine-grained control over which skills the agent can use.
   +4 moreshow less

   • ›Adds live phase display for automation runs, showing the current execution phase in the sidebar in real time.
   • ›Enables pinning a favorite sidebar page as the default home route.
   • ›Links file paths mentioned in chat to the Files drawer, making referenced paths directly navigable.
   • ›Skips onboarding when a user-added Local backend already has a usable LLM configured.
8. v1.15.0 Aug 21, 2026 · issue 004

   OpenHands v1.15.0 adds a getting-started checklist, LLM provider-connections UI, automations catalog installer, and a conversation overview panel.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v1.15.0 https://github.com/OpenHands/OpenHands.git
   # already have the repo? check out this version:
   $ git checkout v1.15.0

   • ›Adds an LLM provider-connections UI for the local agent-server, letting practitioners configure provider connections directly from the interface.
   • ›Adds a getting-started checklist in the sidebar with a settings toggle to guide new users through initial setup.
   • ›Adds the ability to install an automations catalog entry that ships a script bundle, expanding the automations workflow.
   • ›Adds a conversation overview panel and unified commits drawer to the conversation view.
   • ›Shows the workspace path in the Files view for easier orientation within multi-folder workspaces.
   +1 moreshow less

   • ›Batches StreamingDeltaEvents so the UI keeps pace with fast models, enabling reliable real-time streaming at higher throughput.
9. 0.53.0 Aug 19, 2026 · issue 001

   OpenHands now publishes an API — 43 endpoints across 3 areas: Api, Alive, Health

   • ›Api (41 endpoints) — create, read, update, delete
   • ›Alive (1 endpoint) — read
   • ›Health (1 endpoint) — read
10. v1.14.0 Aug 17, 2026 · issue -002

    OpenHands v1.14.0 adds Git Sync automation, LLM pre-flight validation, structured Canvas error outcomes, and sets Kimi K3 as the free default Canvas model.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.14.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.14.0

    • ›Adds a Git Sync page under Automations for managing repository synchronization workflows.
    • ›Adds LLM pre-flight validation when saving LLM profiles, blocking misconfigured settings before they are persisted.
    • ›Canvas now presents structured error outcomes, surfacing failure details in a readable format rather than raw output.
    • ›Sets Kimi K3 as the default Canvas model and tags it as free.
11. v1.14.0 Aug 17, 2026 · issue 001

    OpenHands v1.14.0 adds Git Sync automation, LLM pre-flight validation, structured Canvas error outcomes, and sets Kimi K3 as the free default Canvas model.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.14.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.14.0

    • ›Adds a Git Sync page under Automations for managing repository synchronization workflows.
    • ›Adds LLM pre-flight validation when saving LLM profiles, blocking misconfigured settings before they take effect.
    • ›Canvas now surfaces structured error outcomes, giving clearer feedback when agent tasks fail.
    • ›Sets Kimi K3 as the default Canvas model and tags it as free.
12. v1.14.0 Aug 17, 2026 · issue -002

    OpenHands v1.14.0 adds Git Sync automation, LLM pre-flight validation, structured Canvas error outcomes, and sets Kimi K3 as the free default Canvas model.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.14.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.14.0

    • ›Adds a Git Sync page under Automations for managing repository synchronization workflows.
    • ›Adds LLM pre-flight validation when saving LLM profiles, blocking misconfigured settings before they take effect.
    • ›Canvas now surfaces structured error outcomes, giving clearer feedback when agent tasks fail.
    • ›Sets Kimi K3 as the default Canvas model and tags it as free.
13. v1.13.0 Aug 13, 2026 · issue -006

    OpenHands v1.13.0 adds conversation archiving, inline markdown previews, a context-window meter with manual compaction, and an issue readiness gate.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.13.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.13.0

    • ›Adds client-side conversation archive so users can archive and manage past conversations directly in the UI.
    • ›Adds inline markdown artifact previews inside the chat panel, rendering markdown output without leaving the conversation.
    • ›Adds a context window usage meter, usage drawer, and manual compaction control so practitioners can monitor and manage LLM context consumption.
    • ›Adds a ready-for-dev issue readiness gate with type-specific criteria to gate issues before they are handed to the agent.
14. v1.13.0 Aug 13, 2026 · issue 001

    OpenHands v1.13.0 adds conversation archiving, inline markdown previews, a context window usage meter, and an issue readiness gate.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.13.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.13.0

    • ›Adds a context window usage meter, usage drawer, and manual compaction so practitioners can monitor and control context consumption in real time.
    • ›Adds client-side conversation archive to organize and declutter past agent sessions.
    • ›Adds inline markdown artifact previews directly in the chat interface.
    • ›Adds a ready-for-dev issue readiness gate with type-specific criteria to validate issues before the agent picks them up.
15. v1.13.0 Aug 13, 2026 · issue -006

    OpenHands v1.13.0 adds conversation archiving, inline markdown previews, a context window usage meter, and an issue readiness gate.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.13.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.13.0

    • ›Adds a context window usage meter, usage drawer, and manual compaction so practitioners can monitor and control context consumption in real time.
    • ›Adds client-side conversation archive to organize and declutter past agent sessions.
    • ›Adds inline markdown artifact previews directly in the chat interface.
    • ›Adds a ready-for-dev issue readiness gate with type-specific criteria to validate issues before the agent picks them up.
16. v1.11.0 Aug 7, 2026 · issue -012

    OpenHands v1.11.0 adds per-run LLM cost visibility, tag filtering for automations, and typed child-conversation actions.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.11.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.11.0

    • ›Adds per-run LLM cost display in the Activity Log and exports, giving operators visibility into token spend for each individual run.
    • ›Adds automation tag filter and recognition, enabling users to filter automations by tag in the UI.
    • ›Adds tag chips, overflow handling, and hovercard labels to the conversations view for at-a-glance context.
    • ›Adds a typed agent action for launching local or Cloud child conversations, expanding programmatic multi-conversation workflows.
    • ›Reorders the Customize navigation section for improved discoverability.
    +1 moreshow less

    • ›Keeps the Automations pane visible on the home screen even when empty, reducing confusion for new automation setups.
17. v1.11.0 Aug 7, 2026 · issue 001

    OpenHands v1.11.0 adds per-run LLM cost tracking, tag filtering for automations, and typed child-conversation agent actions.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.11.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.11.0

    • ›Adds per-run LLM cost display in the Activity Log and exports, giving teams visibility into spend at the individual run level.
    • ›Adds a typed agent action for launching local or Cloud child conversations, enabling agents to programmatically spawn sub-conversations.
    • ›Adds automation tag filter and recognition, letting users filter the Automations pane by tag.
    • ›Adds tag chips, overflow handling, and hovercard labels to the conversations view for richer conversation metadata display.
    • ›Keeps the Automations pane visible when empty so the panel is always accessible.
    +2 moreshow less

    • ›Reorders the Customize navigation section for improved discoverability.
    • ›Polishes the Agent Canvas version update UI in Settings.
18. v1.11.0 Aug 7, 2026 · issue -012

    OpenHands v1.11.0 adds per-run LLM cost tracking, tag filtering for automations, and typed child-conversation agent actions.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.11.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.11.0

    • ›Adds per-run LLM cost display in the Activity Log and exports, giving teams visibility into spend at the individual run level.
    • ›Adds a typed agent action for launching local or Cloud child conversations, enabling agents to programmatically spawn sub-conversations.
    • ›Adds automation tag filter and recognition, letting users filter the Automations pane by tag.
    • ›Adds tag chips, overflow handling, and hovercard labels to the conversations view for richer conversation metadata display.
    • ›Keeps the Automations pane visible when empty so the panel is always accessible.
    +2 moreshow less

    • ›Reorders the Customize navigation section for improved discoverability.
    • ›Polishes the Agent Canvas version update UI in Settings.
19. v1.10.0 Aug 5, 2026 · issue -014

    OpenHands v1.10.0 adds activity log export, a featured automations dashboard, manifest-driven automation sub-pages, and faceted skills filtering.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.10.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.10.0

    • ›Adds activity log export capability to the interface.
    • ›Ships a featured automations landing dashboard for discovering and launching automations.
    • ›Adds manifest-driven sub-pages to the automation interface, enabling structured multi-page automation flows.
    • ›Adds a faceted rail filter to the Skills page for narrowing down skills by category.
    • ›Sets the Canvas default model to GLM 5.2.
20. v1.10.0 Aug 5, 2026 · issue 001

    OpenHands v1.10.0 adds activity log export, a featured automations dashboard, manifest-driven automation sub-pages, and faceted skills filtering.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.10.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.10.0

    • ›Adds activity log export capability to the interface.
    • ›Ships a featured automations landing dashboard for discovering and launching automations.
    • ›Adds manifest-driven sub-pages to the automation interface, enabling structured automation workflows.
    • ›Adds a faceted filter rail to the Skills page for narrowing skills by category.
    • ›Sets the Canvas default model to GLM 5.2.
21. v1.10.0 Aug 5, 2026 · issue -014

    OpenHands v1.10.0 adds activity log export, a featured automations dashboard, manifest-driven automation sub-pages, and faceted skills filtering.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.10.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.10.0

    • ›Adds activity log export capability to the interface.
    • ›Ships a featured automations landing dashboard for discovering and launching automations.
    • ›Adds manifest-driven sub-pages to the automation interface, enabling structured automation workflows.
    • ›Adds a faceted filter rail to the Skills page for narrowing skills by category.
    • ›Sets the Canvas default model to GLM 5.2.
22. v1.9.0 Aug 3, 2026 · issue -016

    OpenHands v1.9.0 adds live agent activity in chat, a streamlined backend chooser, and an extension-manifest host.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.9.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.9.0

    • ›Adds a compact Cloud vs Agent-server add-backend chooser to streamline switching between backend types.
    • ›Shows live agent activity directly in the chat UI so users can follow along in real time.
    • ›Introduces a domain-neutral extension-manifest host to support broader extension compatibility.
23. v1.9.0 Aug 3, 2026 · issue 001

    OpenHands v1.9.0 adds live agent activity in chat, a compact backend chooser, and an extension-manifest host.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.9.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.9.0

    • ›Shows live agent activity streamed directly in the chat view so users can follow what the agent is doing in real time.
    • ›Adds a compact Cloud vs Agent-server backend chooser UI to the backends settings, making it faster to switch between hosting modes.
    • ›Introduces a domain-neutral extension-manifest host to support loading extensions independently of the deployment domain.
    • ›Drives the automation UI from the interface manifest, enabling manifest-controlled automation flows.
24. v1.9.0 Aug 3, 2026 · issue -016

    OpenHands v1.9.0 adds live agent activity in chat, a compact backend chooser, and an extension-manifest host.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.9.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.9.0

    • ›Shows live agent activity streamed directly in the chat view so users can follow what the agent is doing in real time.
    • ›Adds a compact Cloud vs Agent-server backend chooser UI to the backends settings, making it faster to switch between hosting modes.
    • ›Introduces a domain-neutral extension-manifest host to support loading extensions independently of the deployment domain.
    • ›Drives the automation UI from the interface manifest, enabling manifest-controlled automation flows.
25. v1.8.0 Jul 30, 2026 · issue -020

    OpenHands v1.8.0 adds per-card enable/disable toggling for installed MCP servers.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.8.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.8.0

    • ›Adds the ability to enable or disable an installed MCP server directly from its card in the UI, without uninstalling it.
26. v1.8.0 Jul 30, 2026 · issue 001

    OpenHands v1.8.0 adds the ability to enable or disable installed MCP servers directly from their card in the UI.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.8.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.8.0

    • ›Adds a toggle on each installed MCP server's card to enable or disable it without uninstalling.
27. v1.8.0 Jul 30, 2026 · issue -020

    OpenHands v1.8.0 adds the ability to enable or disable installed MCP servers directly from their card in the UI.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.8.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.8.0

    • ›Adds a toggle on each installed MCP server's card to enable or disable it without uninstalling.
28. v1.7.0 Jul 29, 2026 · issue -021

    OpenHands v1.7.0 adds persistent agent memory toggle, LLM selector always visible, and secret overwrite from edit form.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.7.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.7.0

    • ›Adds a persistent agent memory toggle in the UI, letting users enable or disable memory retention across agent sessions.
    • ›LLM selector is now always visible in the UI; agent-profile switching has been moved to the tools menu.
    • ›Allows overwriting an existing secret value directly from the secret edit form.
29. v1.7.0 Jul 29, 2026 · issue 001

    OpenHands v1.7.0 adds persistent agent memory toggle, always-visible LLM selector, and secret overwriting from the edit form.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.7.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.7.0

    • ›Adds a persistent agent memory toggle so agents can retain context across sessions.
    • ›Makes the LLM selector always visible in the UI; moves agent-profile switching into the tools menu.
    • ›Allows overwriting an existing secret value directly from the secret edit form.
30. v1.7.0 Jul 29, 2026 · issue -021

    OpenHands v1.7.0 adds persistent agent memory toggle, always-visible LLM selector, and secret overwriting from the edit form.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v1.7.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout v1.7.0

    • ›Adds a persistent agent memory toggle so agents can retain context across sessions.
    • ›Makes the LLM selector always visible in the UI; moves agent-profile switching into the tools menu.
    • ›Allows overwriting an existing secret value directly from the secret edit form.
31. cloud-1.47.0 Jul 21, 2026 · issue -029

    OpenHands cloud-1.47.0 gates Agent Canvas behind SaaS authentication.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch cloud-1.47.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout cloud-1.47.0

    • ›Protects Agent Canvas behind SaaS authentication, restricting access to authenticated users.
32. cloud-1.47.0 Jul 21, 2026 · issue 001

    OpenHands cloud-1.47.0 gates Agent Canvas behind SaaS authentication.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch cloud-1.47.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout cloud-1.47.0

    • ›Agent Canvas is now protected behind SaaS authentication, restricting access to authenticated users only.
33. cloud-1.47.0 Jul 21, 2026 · issue -029

    OpenHands cloud-1.47.0 gates Agent Canvas behind SaaS authentication.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch cloud-1.47.0 https://github.com/OpenHands/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout cloud-1.47.0

    • ›Agent Canvas is now protected behind SaaS authentication, restricting access to authenticated users only.
34. cloud-1.46.0 Jul 10, 2026 · issue -040

    OpenHands 1.46 adds configurable BYOR key alias patterns and enriched final archive manifests.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch cloud-1.46.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout cloud-1.46.0

    • ›Enables configurable key alias patterns for Bring Your Own Router (BYOR) keys in enterprise deployments.
    • ›Enriches final archive manifests with additional metadata and removes initial snapshots to streamline workspace archives.
35. 1.11.0 Jul 9, 2026 · issue -041

    OpenHands 1.11.0 adds Agent Profiles, a Budgets dashboard, expanded usage monitoring, and email surface visibility.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.11.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.11.0

    └──▷ HOW TO FIND IT
    Check whether your SMTP or Resend email integration is active without digging through config files.
    📍In the console, go to Settings › Email and verify that the email provider status is shown as enabled.
    Monitor team spend and enforce cost limits by reviewing the new Budgets dashboard.
    📍In the console, go to Budgets to view configured budget limits and current usage, and to the Usage Dashboard for a breakdown of consumption by user or project.
    • ›Adds Agent Profiles on the cloud/SaaS backend, enabling enterprise teams to configure and manage distinct agent personas.
    • ›Introduces a Budgets dashboard and expands the Usage Dashboard for spend tracking and resource monitoring.
    • ›New budgets and usage monitoring UI surfaces consumption data directly in the product.
    • ›Surfaces email provider status (SMTP/Resend) so admins can confirm email delivery is enabled.
    • ›Passes repository metadata to observability traces, enriching trace context for debugging agent runs.
36. cloud-1.45.0 Jul 9, 2026 · issue -041

    OpenHands 1.45 adds Agent Profiles, a Budgets dashboard, expanded Usage Dashboard, and email provider status surfacing.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch cloud-1.45.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout cloud-1.45.0

    • ›Adds Agent Profiles support on the cloud/SaaS backend, enabling enterprise-level agent configuration management.
    • ›Introduces a Budgets dashboard for tracking and enforcing spending limits.
    • ›Expands the Usage Dashboard with additional monitoring metrics and UI.
    • ›Surfaces email-enabled status for SMTP and Resend email providers in the admin UI.
37. cloud-1.44.0 Jul 9, 2026 · issue -041

    OpenHands 1.44.0 adds repository metadata to observability traces for richer debugging context.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch cloud-1.44.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout cloud-1.44.0

    • ›Includes repository metadata in observability traces, enabling richer context when debugging agent runs.
38. cloud-1.43.0 Jul 8, 2026 · issue -042

    OpenHands cloud gains SMTP email service, user login tracking, and a renamed Usage & Monitoring dashboard.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch cloud-1.43.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout cloud-1.43.0

    • ›Adds SMTP email service integration for outbound email delivery.
    • ›Surfaces email-enabled status for both SMTP and Resend email providers in the UI.
    • ›Tracks user login timestamps for visibility into account activity.
    • ›Renames the admin dashboard to 'Usage & Monitoring'.
39. 1.10.0 Jul 8, 2026 · issue -042

    OpenHands 1.10.0 adds SMTP email service, user login timestamp tracking, and renames the admin dashboard to Usage & Monitoring.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.10.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.10.0

    • ›Adds SMTP email service integration for outbound email delivery alongside the existing Resend provider.
    • ›Surfaces email-enabled status in the UI for both SMTP and Resend configurations.
    • ›Tracks user login timestamps for audit and monitoring purposes.
    • ›Renames the admin dashboard to 'Usage & Monitoring'.
40. cloud-1.42.0 Jul 7, 2026 · issue -043

    OpenHands 1.42.0 adds a super-admin management API for granting, revoking, and listing admin privileges in enterprise deployments.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch cloud-1.42.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout cloud-1.42.0

    • ›New enterprise super-admin management endpoint lets administrators programmatically grant, revoke, and list super-admin roles via API.
41. 1.9.1 Jul 7, 2026 · issue -043

    OpenHands 1.9.1 adds a super-admin management API for granting, revoking, and listing admin privileges.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.9.1 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.9.1

    • ›New enterprise/auth super-admin management endpoint supports grant, revoke, and list operations for super-admin roles.
42. cloud-1.41.0 Jul 6, 2026 · issue -044

    OpenHands 1.41 adds tree-sitter semantic chunking, parallel tool calls, time-bounded API keys, and an org admin conversation dashboard.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch cloud-1.41.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout cloud-1.41.0

    └──▷ HOW TO FIND IT
    Restrict an API key to a specific validity window so it auto-expires after a contractor engagement ends.
    📍In the console, go to Settings › API Keys, create or edit a key, and set the 'Not Before' and 'Expires At' fields to define the active window.
    Speed up agent tasks that invoke multiple tools by allowing them to run concurrently instead of sequentially.
    📍In the console, go to Agent Settings and set 'tool_concurrency_limit' to the desired number of parallel tool calls (e.g., 4).
    • ›Adds semantic file chunking using tree-sitter AST parsing for more accurate code understanding during agent tasks.
    • ›New organization conversation admin dashboard gives org admins visibility into all conversations under their org.
    • ›Workspace state is now snapshotted at session start and archived before deletion, preserving production workspace history.
    • ›Parallel tool calls are now configurable via a tool_concurrency_limit agent setting, enabling concurrent tool execution.
    • ›API keys gain optional active-window controls (not_before and expires_at) for time-bounded access.
    +7 moreshow less

    • ›API keys now support an explicit 'unbound' org scope as a first-class option.
    • ›New GET /organizations/{id}/me endpoint exposes the caller's permissions within an organization.
    • ›Enterprise super roles can be assigned via user.role_id with permission fallback for fine-grained access control.
    • ›Repo and branch metadata is now attached to Laminar trace entries for better observability of agent runs.
    • ›Dynamic marketplace support added for plugin registration, enabling third-party plugin discovery.
    • ›SaaS auth now accepts an api_key cookie as a fallback credential alongside header-based auth.
    • ›Jira Data Center integration panel now surfaces member-appropriate guidance instead of the admin setup form for non-admin users.
43. 1.9.0 Jul 6, 2026 · issue -044

    OpenHands 1.9.0 adds multi-model LLM discovery, Azure DevOps resolver, MCP server config for ACP agents, sub-agent task visualizer, and enterprise admin provisioning.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.9.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.9.0

    └──▷ USE IT
    Set a per-deployment resolver label to customize which resolver macro handles automation events.
    ini copy

    OH_RESOLVER_LABEL=my-team-resolver

    Set the deployment mode to enterprise cloud to gate cloud-account CTAs appropriately.
    ini copy

    OH_DEPLOYMENT_MODE=enterprise_cloud

    • ›Adds hide_personal_workspaces flag to restrict org-only OHE installs to organization workspaces only.
    • ›Adds switch_acp_model proxy endpoint for switching LLM models mid-conversation in cloud ACP sessions.
    • ›Adds model dropdown and credential fields to the agent settings page for ACP agents.
    • ›Supports MCP server configuration for ACP agents.
    • ›Adds OHE multi-model LLM discovery with BYOK gating, proxy discovery, catalogue union, and UX.
    +29 moreshow less

    • ›Exposes copyable invite links so organization invitations work without email delivery.
    • ›Accepts pending invitations by verified-email match at sign-in, removing friction for new members.
    • ›Auto-accepts invitation links on click instead of showing a confirm/cancel modal.
    • ›Adds explicit OH_DEPLOYMENT_MODE flag to gate cloud-account CTAs to enterprise cloud deployments.
    • ›Adds OH_RESOLVER_LABEL environment variable for per-deployment resolver macro customization.
    • ›Adds Azure DevOps resolver with @mentions support and org-level one-click webhook setup.
    • ›Adds Jira Data Center email-mode auto-link, targeted repo lookup, and picker mentions.
    • ›Persists and injects per-user OAuth tokens in Jira DC resolver conversations.
    • ›Supports Slack attachments in agent context.
    • ›Adds sub-agent task (TaskToolSet) visualizer to the chat UI.
    • ›Adds a 'Full Git history' user setting.
    • ›Adds enterprise admin user-provisioning endpoint.
    • ›Adds default_sandbox_spec_id to user settings.
    • ›Adds parallel tool calls via tool_concurrency_limit in agent settings.
    • ›Implements semantic file chunking using tree-sitter AST parsing.
    • ›Adds organization conversation admin dashboard.
    • ›Captures production workspace state with initial snapshot at start and archive before delete.
    • ›Adds super roles via user.role_id with permission fallback for enterprise auth.
    • ›Exposes caller permissions on GET /organizations/{id}/me.
    • ›Adds optional active window (not_before & expires_at) for API keys.
    • ›Makes 'unbound' org scope an explicit, first-class option for API keys.
    • ›Adds dynamic marketplace support for plugin registration.
    • ›Accepts api_key cookie as a fallback credential for SaaS auth.
    • ›Parallelizes GitHub GraphQL queries in get_suggested_tasks for faster task suggestions.
    • ›Surfaces a clear error when a custom sandbox image's agent-server SDK version mismatches.
    • ›Routes unclaimed automation events to the default org on single-org installs.
    • ›Adds repo/branch metadata to Laminar trace entries.
    • ›Exposes the automations menu item for all users.
    • ›Uses interrupt endpoint for agent pause UI interactions.
44. cloud-1.40.0 Jun 26, 2026 · issue -054

    OpenHands 1.40 adds full Git history cloning, a default sandbox spec setting, Azure DevOps webhook setup, and richer Jira DC integration.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch cloud-1.40.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout cloud-1.40.0

    └──▷ HOW TO FIND IT
    Pin a specific sandbox environment for all your agent runs so you don't have to reconfigure it per session.
    📍In the console, go to Settings › User Settings and set the Default Sandbox Spec to your preferred environment via the default_sandbox_spec_id field.
    Enable full Git history cloning when your agents need to analyze commit history or run git-log-based tools.
    📍In the console, go to Settings › User Settings and enable the Full Git History option.
    Set up org-level Azure DevOps webhooks in one click to automatically trigger OpenHands resolvers on mentions.
    📍In the console, go to Settings › Integrations › Azure DevOps and use the one-click webhook setup under your organization.
    • ›Adds a user setting to enable full Git history cloning (instead of shallow clones) for agents that need deep commit context.
    • ›Adds default_sandbox_spec_id to user settings, letting users pin a preferred sandbox environment across sessions.
    • ›Adds an enterprise admin endpoint for programmatic user provisioning.
    • ›Adds Azure DevOps resolver mentions and org-level one-click webhook setup, simplifying CI/CD trigger configuration.
    • ›Enhances Jira Data Center integration with email-mode auto-linking, targeted repository lookup, and picker mentions.
    +1 moreshow less

    • ›Introduces a dedicated interrupt endpoint powering the agent pause UI, enabling more reliable mid-task agent control.
45. cloud-1.39.0 Jun 24, 2026 · issue -056

    OpenHands 1.39.0 adds ACP model switching, MCP server config for ACP agents, Slack attachment context, multi-model LLM discovery, copyable invite links, and a sub-agent task visualizer.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch cloud-1.39.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout cloud-1.39.0

    └──▷ TRY IT
    Pin a custom resolver label per deployment so automation events are routed to the correct resolver macro.
    copy

    $ OH_RESOLVER_LABEL=my-org-resolver

    Copy and share an org invite link directly from the console so new members can join without waiting for an email.
    📍In the console, go to Settings › Organization › Members and click "Copy invite link" to share a URL that auto-accepts on click.
    • ›Adds switch_acp_model proxy endpoint enabling model switching for cloud ACP conversations.
    • ›Adds model dropdown and credential fields to the agent settings page for ACP agents.
    • ›Supports MCP server configuration for ACP agents.
    • ›Enables multi-model LLM discovery and BYOK gating for OpenHands Enterprise (OHE) installs, including proxy discovery and catalogue union.
    • ›Adds hide_personal_workspaces flag to restrict OHE installs to org-only workspaces.
    +16 moreshow less

    • ›Adds explicit OH_DEPLOYMENT_MODE flag to control deployment mode and gate cloud-account CTAs to enterprise cloud.
    • ›Adds OH_RESOLVER_LABEL env var to configure a per-deployment resolver macro.
    • ›Exposes copyable invite links so org invitations work without email delivery.
    • ›Auto-accepts invitation links on click, removing the confirm/cancel modal.
    • ›Accepts pending invitations by verified-email match at sign-in.
    • ›Adds validation for secret names to ensure valid environment variable format.
    • ›Surfaces Slack attachments as context in agent conversations.
    • ›Adds a sub-agent task (TaskToolSet) visualizer to the chat UI.
    • ›Adds DynamicRemoteSandboxSpecService backed by runtime-API warm configs for dynamic sandbox provisioning.
    • ›Parallelizes GitHub GraphQL queries in get_suggested_tasks for faster task suggestions.
    • ›Surfaces a clear error in the UI when a custom sandbox image's agent-server SDK version mismatches.
    • ›Persists and injects per-user OAuth tokens in Jira Data Center resolver conversations.
    • ›Exposes the Automations menu item to all users.
    • ›Routes unclaimed automation events to the default org on single-org installs.
    • ›Moves existing users into the default org when first auto-added, and makes the first signed-in user the default org owner (tracked via is_default flag).
    • ›Encodes agent harness in the conversation chip icon and surfaces the model name in chip text.
46. 1.8.0 Jun 10, 2026 · issue -070

    OpenHands 1.8.0 adds LLM profiles, sub-agent delegation, sandbox grouping strategies, and a generic ACP agent UI.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.8.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.8.0

    • ›Adds LLM profiles, letting users save and switch between named LLM configurations.
    • ›Enables sub-agent delegation, allowing the primary agent to hand off subtasks to specialised child agents.
    • ›Adds user-selectable sandbox grouping strategy to control how sandbox environments are allocated and shared.
    • ›Introduces a minimal generic ACP (Agent Communication Protocol) agent UI for interacting with ACP-compatible agents.
    └──▷ BREAKING ON UPGRADE

    • !The App tab has been removed from the conversation view.
47. 1.7.0 May 1, 2026 · issue -110

    OpenHands 1.7.0 adds KVM-accelerated sandbox VMs, exposes SDK settings schema, and surfaces LLM model info in the UI.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.7.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.7.0

    • ›New SANDBOX_KVM_ENABLED environment variable lets sandbox containers pass through /dev/kvm, enabling KVM-accelerated virtual machines instead of slow emulation.
    • ›Exposes SDK settings schema to OpenHands, making programmatic configuration discovery available to integrations.
    • ›Displays the active LLM model on conversation cards and the header for at-a-glance visibility.
    • ›Tavily search key moved to MCP settings, centralising external tool credentials under the MCP configuration surface.
48. 1.6.0 Mar 30, 2026 · issue -142

    OpenHands 1.6.0 adds hooks support, /clear and /new chat commands, toggleable global skills, and Catalan UI localization.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.6.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.6.0

    └──▷ HOW TO FIND IT
    Reset chat context mid-session without losing your running sandbox state — useful when a conversation has drifted and you want a clean prompt history.
    📍In the chat input, type /clear and press Enter. A new conversation opens, inheriting the current sandbox and configuration.
    • ›Adds hooks support, enabling extensible event-driven integrations with the OpenHands runtime.
    • ›New /clear slash command starts a fresh conversation that inherits the current sandbox and configuration, preserving runtime state while resetting chat history.
    • ›New /new slash command is now surfaced in the slash command menu for faster access to new conversations.
    • ›Adds ability to enable or disable default global skills, giving operators control over which built-in capabilities are active.
    • ›Adds a copy button to code blocks in the chat UI for easier extraction of generated code.
    +1 moreshow less

    • ›Adds Catalan language support to the UI.
49. 1.5.0 Mar 11, 2026 · issue -160

    OpenHands 1.5.0 adds a planning agent, real-time Task List panel, slash command menu, Bitbucket Datacenter support, and six new models.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.5.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.5.0

    └──▷ HOW TO FIND IT
    Surface available agent skills mid-conversation without leaving the chat input.
    📍In the chat input, type / to open the slash command menu and select an available agent skill or command.
    Monitor the agent's progress across multi-step tasks in real time.
    📍In the right panel, click the Task List tab to view the agent's current tasks and their live status.
    • ›Adds a planning agent for structured, multi-step task execution.
    • ›New Task List tab in the right panel shows the agent's current task list with real-time status updates.
    • ›New slash command menu in the chat input surfaces available agent skills and commands when typing /.
    • ›Enables attaching or changing the Git repository for existing conversations.
    • ›Adds Bitbucket Datacenter as a supported Git provider.
    +1 moreshow less

    • ›Adds support for Claude Opus 4.6, Claude Sonnet 4.6, GLM-4.7, GLM-5, Kimi-K2.5, Qwen3-Coder-Next, and Gemini 3.1 Pro Preview models.
50. 1.4.0 Feb 18, 2026 · issue -180

    OpenHands 1.4.0 adds MiniMax-M2.5 model support.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.4.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.4.0

    • ›Adds MiniMax-M2.5 as a supported LLM backend.
51. 1.3.0 Feb 2, 2026 · issue -196

    OpenHands 1.3.0 adds CORS support for remote browser access and host networking mode for reverse proxy setups.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.3.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.3.0

    • ›Adds CORS support to the Docker sandbox service, enabling remote browser access by setting WEB_HOST and SANDBOX_CONTAINER_URL_PATTERN.
    • ›Adds host networking mode via OH_SANDBOX_USE_HOST_NETWORK=true, allowing reverse proxies to reach user-launched applications on any port beyond the predefined worker ports.
52. 1.2.0 Jan 16, 2026 · issue -213

    OpenHands 1.2.0 adds a chat readiness status indicator and doubles the condenser context window default.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.2.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.2.0

    • ›Adds a status indicator above the chat UI that shows when a conversation is ready to receive input.
    • ›Doubles the condenser default max_size from 120 to 240, allowing larger context to be retained before summarization.
53. 1.1.0 Dec 30, 2025 · issue -230

    OpenHands 1.1.0 adds OAuth 2.0 Device Flow for CLI auth, Forgejo integration, and conversation export.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.1.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.1.0

    └──▷ HOW TO FIND IT
    Authenticate the OpenHands CLI from a headless server or remote shell without needing a browser on the same machine.
    📍In the OpenHands CLI, select 'Login' and follow the Device Flow prompt: visit the displayed URL on any device and enter the code to authorize the session.
    Save a full agent conversation for audit, review, or sharing — useful after a complex remediation session.
    📍In the OpenHands UI, open the conversation panel, locate the session, and click 'Export Conversation' to download the conversation as a file.
    • ›Adds OAuth 2.0 Device Flow for CLI authentication, enabling headless and browser-less login workflows.
    • ›Adds Forgejo integration, extending repository provider support to the self-hosted Forgejo platform.
    • ›Adds an Export Conversation button in the conversation panel to save full conversation history.
    • ›Adds a Refresh button on the Changes tab for on-demand file-diff updates without reloading.
54. 1.0.0 Dec 16, 2025 · issue -244

    OpenHands 1.0.0 adds Azure DevOps integration, a new task tracker UI, and native tool calling for Gemini 2.5 Pro.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.0.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.0.0

    • ›Adds Azure DevOps integration support for repository and pipeline connectivity.
    • ›New task tracker interface provides structured visibility into agent task progress.
    • ›Chat messages are now queued during runtime connection, enabling smoother interaction during agent startup.
55. 0.62.0 Nov 11, 2025 · issue -279

    OpenHands 0.62.0 adds conversation tab pinning and a Documentation link in the profile menu.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.62.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.62.0

    └──▷ HOW TO FIND IT
    Keep a frequently referenced conversation always accessible by pinning it.
    📍In the OpenHands UI, right-click or use the tab options on a conversation tab and select 'Pin' to pin it; select 'Unpin' to remove the pin.
    • ›Enables pinning and unpinning of conversation tabs for quick access to important sessions.
    • ›Adds a Documentation link directly in the profile menu for faster access to reference material.
56. 0.61.0 Nov 5, 2025 · issue -285

    OpenHands 0.61.0 makes the terminal tab read-only and removes the Jupyter tab from the UI.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.61.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.61.0

    • ›Terminal tab is now read-only, preventing direct user input into the agent's terminal session.
    • ›Jupyter tab has been removed from the UI.
    └──▷ BREAKING ON UPGRADE

    • !The Jupyter tab has been removed from the UI; any workflows relying on it will no longer have access to it.
57. 0.60.0 Oct 29, 2025 · issue -292

    OpenHands 0.60.0 adds Clarifai provider support and automatic sandbox lifecycle management to curb resource exhaustion.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.60.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.60.0

    • ›Adds Clarifai as a supported LLM provider.
    • ›Adds automatic sandbox lifecycle management that limits the number of concurrently running sandboxes to prevent resource exhaustion.
    • ›Simplifies the security analyzer confirmation UI by replacing two reject options with a single 'Reject' option that prompts for an optional reason.
    └──▷ BREAKING ON UPGRADE

    • !The V0 CLI has been removed and is officially unsupported; any setup relying on the V0 CLI will break on upgrade.
58. 0.59.0 Oct 10, 2025 · issue -311

    OpenHands 0.59.0 adds Lemonade as a supported LLM provider.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.59.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.59.0

    • ›Adds Lemonade Provider as a supported LLM backend option.
59. 1.0.0-cli Oct 10, 2025 · issue -311

    OpenHands 1.0.0-cli ships standalone binaries, faster startup, a refreshed UI, and MCP OAuth support.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 1.0.0-cli https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 1.0.0-cli

    • ›Adds multi-platform standalone executable binaries so the CLI runs without any additional setup or runtime install.
    • ›Faster CLI startup when running via uv, pip, and similar tools.
    • ›New and refreshed UI for the CLI experience.
    • ›Simplified JSON MCP configuration with added MCP OAuth support.
60. 0.58.0 Oct 1, 2025 · issue -319

    OpenHands 0.58.0 adds configurable SHTTP MCP server timeouts and claude-sonnet-4-5 model support.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.58.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.58.0

    • ›Adds configurable timeout settings for SHTTP MCP servers, preventing tool calls from hanging indefinitely.
    • ›Adds support for the claude-sonnet-4-5 model.
    • ›Converts the settings panel to a vertical sidebar layout.
61. 0.57.0 Sep 19, 2025 · issue -331

    OpenHands 0.57.0 adds a redesigned UI and Bring Your Own Key (BYOK) support on Cloud.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.57.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.57.0

    └──▷ HOW TO FIND IT
    Use your own LLM API key on OpenHands Cloud instead of the platform's default billing.
    📍In the OpenHands Cloud console, go to Settings and enter your own API key under the Bring Your Own Key (BYOK) section.
    • ›New UI for landing and conversation pages improves the agent interaction experience.
    • ›Adds Bring Your Own Key (BYOK) support on OpenHands Cloud, letting users supply their own LLM API keys.
62. 0.56.0 Sep 9, 2025 · issue -341

    OpenHands 0.56.0 adds AGENTS.md support, microagent management, and multi-LLM routing within agent trajectories.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.56.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.56.0

    • ›Supports AGENTS.md files in microagents, enabling repo-level agent behavior configuration via a standardized file.
    • ›New microagent management feature for organizing and controlling microagents.
    • ›Enables routing between different LLMs within a single agent trajectory, allowing dynamic model selection per task step.
63. 0.55.0 Sep 2, 2025 · issue -348

    OpenHands 0.55.0 adds an LLM risk analyzer and configurable condenser history size limit.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.55.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.55.0

    • ›Adds a configurable max history size setting for the condenser, giving operators control over context window usage.
    • ›Improves performance and UX when working with repositories containing many branches.
64. 0.54.0 Aug 20, 2025 · issue -361

    OpenHands 0.54 adds task tracking with planning mode, MCP on Cloud, and an improved MCP config UI.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.54.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.54.0

    └──▷ HOW TO FIND IT
    Connect an MCP server on OpenHands Cloud to extend the agent with custom tools.
    📍In the OpenHands Cloud console, go to Settings › MCP and use the Add, Edit, or Delete controls to manage your MCP server configurations.
    • ›Adds a task tracking tool and planning mode to help agents manage long-horizon, multi-step tasks.
    • ›Enables Model Context Protocol (MCP) support on OpenHands Cloud.
    • ›Improves the MCP configuration UI with add, edit, and delete functionality.
    • ›Adds a new user feedback reason: 'The agent didn't finish the job'.
65. 0.53.0 Aug 14, 2025 · issue -363

    OpenHands 0.53.0 adds named Docker volume binding, configurable git commit identity, and partial CLI settings updates.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.53.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.53.0

    • ›Supports binding named Docker volumes into the runtime for persistent or shared storage across agent sessions.
    • ›Enables specifying the user identity (name/email) OpenHands commits as when pushing code changes.
    • ›Allows partial modification of CLI settings without needing to restate the full configuration.
66. 0.52.0 Aug 13, 2025 · issue -363

    OpenHands 0.52.0 adds GPT-5, Claude Opus 4.1, Qwen-3-Coder-480B, CLI UI launch, and overlay mount support.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.52.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.52.0

    └──▷ HOW TO FIND IT
    Toggle solvability analysis on or off for the GitHub issue resolver in OpenHands Cloud to control triage depth.
    📍In OpenHands Cloud, go to the Resolver settings and use the solvability analysis switch to enable or disable additional solvability analysis.
    • ›Adds qwen-3-coder-480b to the OpenHands provider model roster.
    • ›Adds gpt-5-2025-08-07 to the OpenHands provider model roster.
    • ›Adds claude-opus-4-1-20250805 as a supported model.
    • ›Adds search API key settings configuration to the CLI.
    • ›Supports launching the full OpenHands UI directly from the CLI.
    +6 moreshow less

    • ›Supports overlay mounts in the Docker runtime for more flexible workspace setups.
    • ›Adds a toggle to enable or disable solvability analysis in the resolver on OpenHands Cloud.
    • ›Includes branch information in repository context provided to agents.
    • ›Adds auto-pagination with infinite scroll for the conversation list.
    • ›Expands conversation history limit from 20 to 100 entries.
    • ›Adds proper markdown rendering for agent messages and final thoughts in the CLI interface.
67. 0.51.0 Jul 31, 2025 · issue -364

    OpenHands 0.51 adds MCP support for the CLI, multi-repo git change detection, and smarter resolver summaries.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.51.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.51.0

    • ›Adds MCP (Model Context Protocol) support to the CLI, enabling tool-server integrations previously only available in the UI.
    • ›Optimizes git change detection in the Changes tab with performance improvements and multi-repository support.
    • ›Improves resolver summary generation by focusing each summary only on new changes since the last one, reducing repetition across consecutive summaries.
68. 0.50.0 Jul 24, 2025 · issue -364

    OpenHands 0.50 adds Moonshot AI Kimi-K2 model support and new CLI confirmation dialog options

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.50.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.50.0

    • ›Adds Moonshot AI Kimi-K2 (kimi-k2-0711-preview) as a recommended and natively supported model via the OpenHands provider.
    • ›Adds new options to CLI confirmation dialogs, giving practitioners more control over interactive approval flows.
    • ›Persists alias choices in the CLI across sessions, reducing repetitive configuration.
    • ›Improves MCP settings UI layout and clarity for easier Model Context Protocol configuration.
69. 0.49.0 Jul 16, 2025 · issue -364

    OpenHands 0.49 adds CLI/VSCode integration, a new Memory UI, OpenHands Cloud LLM provider, and conversation management improvements.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.49.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.49.0

    └──▷ TRY IT
    Check which config file OpenHands is loading without digging through docs — useful when managing multiple environments.
    copy

    $ /settings

    • ›Adds CLI/VSCode integration, enabling OpenHands to be used directly from the command line and VS Code.
    • ›Introduces an OpenHands Cloud LLM provider, letting users route model calls through OpenHands Cloud.
    • ›New Memory UI feature surfaces agent memory state in the interface.
    • ›Conversation cards now display branch name and git provider at a glance.
    • ›Suggested tasks are now split and organized by git provider.
    +3 moreshow less

    • ›Users can edit a conversation's title directly in the UI.
    • ›CLI alias setup for first-time users: on first run, users are offered the option to create openhands and oh shell aliases for faster launch.
    • ›CLI /settings command now displays the active configuration file path.
70. 0.48.0 Jul 2, 2025 · issue -364

    OpenHands 0.48 adds user-directory microagents, .cursorrules support, conversation stop control, and setup.sh event visibility.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.48.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.48.0

    • ›Supports loading microagents from the user directory (~/.openhands/microagents/) for per-user agent customization without touching project repos.
    • ›Supports .cursorrules files placed in the project root directory, letting teams reuse existing Cursor editor rule sets.
    • ›Adds ability to stop in-progress conversations from the UI.
    • ›Surfaces setup.sh script execution in the event stream so users can observe when and how the setup script runs.
    └──▷ BREAKING ON UPGRADE

    • !The Jupyter plugin is now disabled by default in the CLI runtime; setups that relied on Jupyter being active without explicit configuration will no longer have it enabled.
71. 0.47.0 Jun 27, 2025 · issue -365

    OpenHands 0.47 adds GitLab microagent config directory support and smarter terminal output truncation.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.47.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.47.0

    └──▷ HOW TO FIND IT
    Store org-level microagents in a GitLab repo using the supported alternative directory path so OpenHands can discover them.
    📍In your GitLab group, create a repository named openhands-config and place your microagent .md files under the microagents/ folder — OpenHands will automatically load them per the updated org microagent discovery logic.
    • ›Adds new feedback options for users within the UI.
    • ›Supports openhands-config as an alternative GitLab directory for hosting org-level microagents.
    • ›Changes terminal truncation to trim the middle of long outputs instead of the suffix, preserving both start and end context.
72. 0.46.0 Jun 24, 2025 · issue -365

    OpenHands 0.46 adds custom model names, vi-mode CLI keybindings, configurable safety settings, and system prompt overrides.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.46.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.46.0

    └──▷ TRY IT
    Enable vi-style j/k navigation in CLI confirmation menus for keyboard-driven workflows.
    copy

    $ CLI_VI_MODE=true python -m openhands.core.cli

    • ›Supports custom/arbitrary model names during CLI model selection, beyond the preset list.
    • ›Adds optional vi-style keybindings (j/k navigation) for CLI confirmation prompts, enabled via the CLI_VI_MODE environment variable.
    • ›Adds customizable safety settings for Mistral AI and Gemini models.
    • ›Enables overriding the hardcoded system prompt for full prompt control.
    • ›Allows users to submit feedback on agent performance even when the agent hit an error or is awaiting user input.
73. 0.45.0 Jun 20, 2025 · issue -365

    OpenHands 0.45 adds Kubernetes runtime, Bitbucket integration, file/image uploads, per-conversation budgets, and Japanese UI.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.45.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.45.0

    • ›Adds Kubernetes Runtime support as a new sandbox execution backend.
    • ›Supports file and image uploads directly within conversations.
    • ›Adds Bitbucket integration for local usage alongside existing GitHub support.
    • ›Enables per-conversation budget configuration to cap LLM spending.
    • ›Adds Japanese language support to the UI.
    +1 moreshow less

    • ›Increases max iterations per task from 250 to 500, enabling more complex autonomous workflows.
    └──▷ BREAKING ON UPGRADE

    • !The local configuration directory has moved from ~/.openhands-state to ~/.openhands; existing state stored in the old path will not be picked up automatically after upgrading.
74. 0.44.0 Jun 20, 2025 · issue -365

    OpenHands 0.44 adds draft PR/MR control via Git MCP, Slack integration in settings, and SWE-bench-Live evaluation support.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.44.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.44.0

    └──▷ HOW TO FIND IT
    Install the Slack integration for your Cloud OpenHands workspace without leaving the product.
    📍In the Cloud OpenHands console, go to Settings › Integrations and follow the prompts to install the Slack integration.
    • ›Agents can now control whether PRs/MRs opened via Git MCP are created as drafts or ready-for-review.
    • ›Adds Slack integration installable directly from the Integrations tab in the Cloud OpenHands Settings page.
    • ›Supports evaluation runs on SWE-bench-Live for more realistic, up-to-date issue-resolving benchmarks.
    • ›Dev container networking now works without host network mode, improving security and portability of the dev setup.
75. 0.43.0 Jun 20, 2025 · issue -365

    OpenHands 0.43 adds Slack integration (beta), a Microagents UI, GitLab lower-scoped token support, and a code review microagent example.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.43.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.43.0

    └──▷ HOW TO FIND IT
    Browse available microagents mid-conversation to understand what specialized knowledge is loaded before asking a domain-specific question.
    📍In the conversation UI, open the context menu and select 'Microagents' to view the list of active specialized microagents for the current session.
    • ›New Slack integration (beta) with Cloud OpenHands for triggering and interacting with agents via Slack.
    • ›New Microagents UI in the conversation context menu lets users see what specialized knowledge microagents are available in their current conversation.
    • ›New example code review microagent provides a ready-made template for automated code review workflows.
    • ›Supports lower-scoped GitLab tokens, enabling more granular permission control when connecting GitLab repositories.
    • ›Adds JSON serialization for array and object parameters when converting tools, broadening tool-call compatibility.
    └──▷ BREAKING ON UPGRADE

    • !The CLI default provider is changed from openai to anthropic; existing CLI users relying on the default will now target Anthropic instead of OpenAI.
    • !CLI settings are now saved directly under ~/.openhands instead of the previous location; existing CLI config files stored elsewhere will no longer be read automatically.
76. 0.42.0 Jun 10, 2025 · issue -365

    OpenHands 0.42.0 adds API endpoints to control conversation lifecycle and lets users update their email address.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.42.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.42.0

    • ›New API endpoints to explicitly start and stop conversations programmatically.
    • ›New VSCODE_IN_NEW_TAB feature flag to open the VS Code editor in a new browser tab.
77. 0.41.0 Jun 5, 2025 · issue -365

    OpenHands 0.41.0 adds Cloud GitLab Resolver, streamable HTTP MCP support, and native Windows runtime.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.41.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.41.0

    • ›Adds Cloud GitLab Resolver, enabling automated issue/PR resolution against cloud-hosted GitLab repositories.
    • ›Implements streamable HTTP MCP transport, supporting MCP servers served over HTTP streams.
    • ›Adds native Windows support without requiring WSL, broadening local deployment options.
    • ›Improves CLI mode setup flow to guide users through configuration when settings are missing.
78. 0.40.0 Jun 1, 2025 · issue -365

    OpenHands 0.40.0 adds native PR/MR creation via MCP, LocAgent integration, and a first-class search API.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.40.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.40.0

    • ›Enables native PR/MR opening on GitHub and GitLab via in-house MCP integration.
    • ›Incorporates LocAgent into OpenHands for improved code localization capabilities.
    • ›Adds first-class search API support to OpenHands.
    • ›Adds Interactive SWE-Bench benchmark for evaluating agent performance.
    • ›Improves MCP tool usage visualization in the UI.
79. 0.39.0 May 20, 2025 · issue -366

    OpenHands 0.39.0 adds UI-based custom secret management and nested runtime API support for scalable agent deployments.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.39.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.39.0

    └──▷ HOW TO FIND IT
    Store a custom API key or credential so the agent can securely access it during task execution — no code change required.
    📍In the console, go to Settings › Secrets and add a new custom secret (name + value) to make it available to the agent at runtime.
    • ›Adds ability to save custom secrets for agents directly through the UI settings panel.
    • ›Adds API support for nested runtimes, enabling more flexible and scalable agent deployments.
    └──▷ BREAKING ON UPGRADE

    • !Only volumes explicitly mounted to /workspace will be treated as workspace mounts; other volume mounts no longer receive workspace treatment on upgrade.
80. 0.38.0 May 12, 2025 · issue -366

    OpenHands 0.38.0 adds Windows runtime, MCP config UI, self-hosted Git support, and user/org microagents.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.38.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.38.0

    └──▷ HOW TO FIND IT
    Configure MCP servers for the agent via the settings UI.
    📍In the OpenHands UI, go to Settings › MCP and add your MCP server configurations.
    • ›Adds self-hosted GitLab and enterprise GitHub host settings for local installations.
    • ›Supports user-defined runners for the resolver, enabling custom execution environments.
    • ›Adds Windows local runtime support with PowerShell.
    • ›Enables the agent to save browser screenshots as image files during sessions.
    • ›Supports loading custom Agent implementations from arbitrary Python packages via config.toml.
    +3 moreshow less

    • ›Adds MCP (Model Context Protocol) configuration directly in the settings UI.
    • ›Supports user- and org-level microagents for shared, reusable agent configurations.
    • ›Simplifies workspace mounting via the SANDBOX_VOLUMES configuration.
81. 0.37.0 May 7, 2025 · issue -366

    OpenHands 0.37.0 adds branch picker for repositories and per-user configurable conversation starters.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.37.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.37.0

    └──▷ HOW TO FIND IT
    Target a specific branch when starting work on a repository from the homepage, without manually switching branches later.
    📍In the console, go to the Homepage, select your repository, then use the branch picker to choose the desired branch before starting a conversation.
    Disable proactive conversation starters for Cloud Resolver if you prefer a quieter, prompt-only experience.
    📍In the console, go to Account Settings and toggle 'Proactive conversation starters' off.
    • ›Adds a branch picker for repository selection on the homepage.
    • ›Enables per-user configuration of proactive conversation starters for Cloud Resolver, togglable in account settings (enabled by default).
    • ›Adds helpful tips to the Changes tab zero state.
82. 0.36.0 May 1, 2025 · issue -366

    OpenHands 0.36.0 adds CLI agent pause/resume, documentation search, and raises the conversation panel limit to 20.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.36.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.36.0

    • ›Adds pause and resume functionality for agents running in the CLI.
    • ›Adds search support for documentation within the product.
    • ›Separates settings into multiple distinct sections in the UI.
    • ›Increases the conversation panel limit from 9 to 20.
83. 0.35.0 Apr 29, 2025 · issue -367

    OpenHands 0.35 adds API key management UI, GitLab suggested tasks, a VS Code tab, and new CLI commands.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.35.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.35.0

    └──▷ TRY IT
    Quickly start a new session, check status, or open settings without leaving the CLI.
    copy

    $ /new
    /status
    /settings

    Manage API keys for programmatic access to OpenHands Cloud from the settings page.
    📍In the OpenHands Cloud console, go to Settings › API Keys to create or revoke keys.
    • ›Supports viewing and launching suggested tasks for GitLab repositories directly from the homepage.
    • ›Replaces the Workspace tab with a VS Code tab for in-browser code editing.
    • ›Enables /new, /status, and /settings commands in the CLI.
    • ›Sorts GitHub repos in OpenHands Cloud by most recently pushed, making active repos easier to find.
    • ›Simplifies microagent authoring: names in frontmatter are no longer required — only triggers matter for dynamically loaded microagents.
84. 0.34.0 Apr 23, 2025 · issue -367

    OpenHands 0.34 adds a Changes tab for reviewing agent modifications, custom sandboxes for the resolver, and tool disabling controls.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.34.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.34.0

    └──▷ HOW TO FIND IT
    When reviewing what an agent changed in a session, open the Changes tab to see a diff of all modified files before accepting or rolling back.
    📍In the OpenHands UI, open an active or completed session and click the Changes tab to view a diff of all files modified by the agent.
    • ›New Changes tab in the UI surfaces all file modifications made by OpenHands during a session, making agent-driven diffs reviewable at a glance.
    • ›Adds ability to disable specific default tools, giving operators fine-grained control over which capabilities the agent can invoke.
    • ›Supports custom sandbox images for the resolver, enabling reproducible, project-specific environments when resolving GitHub issues.
    • ›Resolver now names branches with the openhands/ prefix, establishing a consistent convention for identifying agent-created branches.
    • ›Updated home screen layout improves navigation and workspace entry points.
    └──▷ BREAKING ON UPGRADE

    • !Resolver branches are now created with the openhands/ prefix — any automation or filters matching previous branch name patterns must be updated.
85. 0.33.0 Apr 16, 2025 · issue -367

    OpenHands 0.33 adds native MCP server support, GitLab OAuth/PAT integration, GitHub Enterprise resolver, and interactive CLI commands.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.33.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.33.0

    • ›Supports MCP servers natively via CodeActAgent, enabling model context protocol tool use within agents.
    • ›Adds GitLab API integration with both OAuth and PAT token authentication.
    • ›Enables PR type specification when using the GitHub Action resolver.
    • ›Supports GitHub Enterprise and on-premises GitLab in the GitHub Action resolver.
    • ›Adds interactive CLI commands /init, /help, and /exit with an enhanced startup experience.
    +2 moreshow less

    • ›Displays agent 'think' actions as collapsible elements in the conversation view.
    • ›Improves SWE-bench_Verified single-pass baseline results to 59.6%.
86. 0.32.0 Apr 10, 2025 · issue -367

    OpenHands 0.32 adds microagent context visibility, PR template awareness, and enables context condensation by default.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.32.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.32.0

    • ›Displays microagent context directly in the UI so practitioners can see which microagent knowledge is active during a session.
    • ›Shows edited file paths in the conversation headline for at-a-glance change tracking.
    • ›Enables context condensation by default, automatically compressing long conversation histories to stay within model context limits.
    • ›Expands GitLab repository listing to include repos where the user has membership but is not the owner.
    • ›Supports microagent files without a required header, reducing friction when authoring custom microagents.
    +3 moreshow less

    • ›Adds a user-friendly UI message for content policy violation errors.
    • ›Prompts the agent to follow existing PR templates when creating new pull requests.
    • ›Improves event retrieval performance for conversations with a large number of events.
    └──▷ BREAKING ON UPGRADE

    • !Condensation is now enabled by default; existing deployments that relied on full, uncompressed conversation history will have condensation applied automatically on upgrade.
87. 0.31.0 Apr 2, 2025 · issue -367

    OpenHands 0.31.0 adds vision-based browsing with PDF/image support, OpenHands LM integration, and multi-provider Git configuration.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.31.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.31.0

    └──▷ HOW TO FIND IT
    Configure both GitHub and GitLab as Git providers at the same time for local OpenHands, so agents can operate across repositories on either platform.
    📍In the OpenHands settings UI, go to Settings › Git Providers and add credentials for both GitHub and GitLab simultaneously.
    • ›Enables vision-based browsing by default, allowing OpenHands to see and interpret PDFs and images rendered in the browser.
    • ›Adds support for OpenHands LM as a new LLM provider option.
    • ›Supports configuring multiple Git providers simultaneously (e.g., GitHub + GitLab) in local OpenHands deployments.
    • ›Generates LLM-based natural-language titles for conversations automatically.
88. 0.30.1 Mar 27, 2025 · issue -368

    OpenHands 0.30.1 adds trajectory replay in the web app and raises the default max iterations to 250.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.30.1 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.30.1

    • ›Adds trajectory replay support in the web app, enabled via the FEATURE_TRAJECTORY_REPLAY feature flag.
    • ›Tracks accumulated token usage across a session instead of per-request token usage, giving a running total.
    • ›Raises the default max iterations from the previous limit to 250, allowing agents to tackle longer tasks out of the box.
    • ›Improves the startup experience for the VSCode extension integration.
89. 0.30.0 Mar 25, 2025 · issue -368

    OpenHands 0.30.0 adds live API cost/token display, web screenshots in headless trajectories, and auto-generated conversation titles.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.30.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.30.0

    • ›Displays API cost and token usage live in the frontend during agent sessions.
    • ›Adds a headless-mode config option to include web screenshots in trajectories for richer audit trails.
    • ›Auto-generates conversation titles from the first user message.
    • ›Improved UI for interactive browser action view.
    • ›Updated file explorer styles for a cleaner workspace experience.
    └──▷ BREAKING ON UPGRADE

    • !Download workspace and download files buttons are removed; users are redirected to VS Code instead.
    • !File upload functionality is removed from the UI; users are redirected to VS Code instead.
    • !The continue button is removed from the UI.
    • !Bash SOFT timeout is reduced from 30 to 10 seconds, which may cause previously passing long-running bash commands to time out.
90. 0.29.1 Mar 19, 2025 · issue -368

    OpenHands 0.29.1 adds a dedicated security microagent for security-focused autonomous tasks.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.29.1 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.29.1

    • ›Adds a security microagent, enabling OpenHands to apply security-specific reasoning and guidance during autonomous coding sessions.
91. 0.29.0 Mar 18, 2025 · issue -368

    OpenHands 0.29.0 adds Swift Linux microagent support and exposes microagent recall observations to the UI and LLM.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.29.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.29.0

    • ›Adds a Swift Linux Installation Microagent for automated Swift environment setup on Linux.
    • ›Makes microagents available in the event stream as recall observations, accessible from both the UI and the LLM.
    • ›Adds TestGenEval benchmark support for evaluating test generation capabilities.
92. 0.28.0 Mar 7, 2025 · issue -368

    OpenHands 0.28 adds Docker-in-runtime, Kubernetes cluster support, a CodeAct thinking tool, microagent templates, and JSON structured logging.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.28.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.28.0

    └──▷ TRY IT
    Enable structured JSON logs so your SIEM or log aggregator can parse OpenHands output without custom parsers.
    copy

    $ LOG_JSON=true docker run --rm -e LOG_JSON=true ghcr.io/all-hands-ai/openhands:0.28.0

    • ›Adds sound and browser notifications for agent state changes, so practitioners are alerted when long-running tasks complete.
    • ›New microagent template system lets users create properly structured domain-specific agents.
    • ›Adds a 'thinking' tool to the CodeAct agent, enabling explicit reasoning steps during task execution.
    • ›Enables OpenHands to run Docker inside its own runtime, unlocking containerized workflows within the agent sandbox.
    • ›Enables OpenHands to start a Kubernetes cluster from within its runtime, supporting cluster-level automation tasks.
    +1 moreshow less

    • ›Adds structured JSON logging via the LOG_JSON environment variable for improved observability and log ingestion.
    └──▷ BREAKING ON UPGRADE

    • !The default Claude model is now claude-3-7-sonnet-20250219 (previously an older version), which may affect costs, behavior, or rate-limit quotas for deployments that rely on the default.
93. 0.27.0 Feb 27, 2025 · issue -369

    OpenHands 0.27 adds custom runtime support, an extended config section, and Claude 3.7 model selection.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.27.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.27.0

    └──▷ USE IT
    Inject arbitrary key-value config into an OpenHands deployment without waiting for first-class support for those keys.
    toml copy

    [extended]
    my_custom_flag = "value"
    another_setting = 42

    Switch the agent to Claude 3.7 when you need its extended thinking or latest capabilities.
    📍In the console, go to Settings › Model and select the Anthropic provider, then choose Claude 3.7 from the model list.
    • ›Adds an [extended] section in config.toml for arbitrary user-defined configuration keys set on the fly.
    • ›Supports selecting Claude 3.7 via the Anthropic provider in model settings.
    • ›Enables advanced users to define and use their own custom runtimes.
94. 0.26.0 Feb 24, 2025 · issue -369

    OpenHands 0.26.0 adds Daytona sandbox runtime, CLI task automation, and UI-configurable memory condensation.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.26.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.26.0

    └──▷ HOW TO FIND IT
    Enable memory condensation to keep long sessions within LLM context limits without manual intervention.
    📍In the console, go to Settings and enable memory condensation.
    • ›Adds Daytona runtime support for managing sandboxes as an alternative execution environment.
    • ›Enables memory condensation configuration directly from the settings page.
    • ›Supports running the CLI with a task argument for fully automated, non-interactive execution.
    • ›Truncates conversation history by half (instead of failing) when the LLM context limit is reached, enabling longer sessions.
95. 0.25.0 Feb 19, 2025 · issue -369

    OpenHands 0.25.0 adds GitLab resolver support, multi-conversation navigation, and a redesigned Settings screen.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.25.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.25.0

    • ›Adds GitLab support for the OpenHands resolver, enabling automated issue and PR resolution on GitLab repositories.
    • ›New multi-conversation navigation lets users switch between different conversations without losing context.
    • ›Redesigned Settings screen provides an updated UI for managing configuration.
    • ›Improves filtering of sensitive data from logs, reducing credential and secret exposure in log output.
96. 0.24.0 Feb 13, 2025 · issue -369

    OpenHands 0.24.0 adds dockerless runtime support and success/failure indicators for file operations.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.24.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.24.0

    • ›Adds preliminary/experimental support for running OpenHands without Docker, broadening deployment flexibility.
    • ›Adds success/failure indicators for file read and edit operations, giving agents clearer feedback on action outcomes.
    • ›Adds comprehensive error logging to PostHog for improved observability of agent failures.
97. 0.23.0 Feb 4, 2025 · issue -369

    OpenHands 0.23.0 adds o3-mini support and live LLM retry visibility with rate-limit resume.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.23.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.23.0

    • ›Supports OpenAI o3-mini as a selectable LLM.
    • ›Shows LLM retries in real time and enables resuming sessions from a Rate-Limited state.
98. 0.22.0 Jan 29, 2025 · issue -370

    OpenHands 0.22.0 adds VisualWebArena evaluation support and drops the Redis dependency.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.22.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.22.0

    • ›Adds VisualWebArena evaluation support, enabling visual web-navigation benchmark testing within OpenHands.
    • ›Removes the Redis dependency, simplifying self-hosted deployments with fewer infrastructure requirements.
99. 0.21.0 Jan 22, 2025 · issue -370

    OpenHands 0.21 adds trajectory replay, downloadable trajectories, multi-language UI, and a dedicated draft-editor LLM config.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch 0.21.0 https://github.com/All-Hands-AI/OpenHands.git
    # already have the repo? check out this version:
    $ git checkout 0.21.0

    └──▷ HOW TO FIND IT
    Route edit-draft generation to a cheaper or faster model while keeping your primary LLM for reasoning — set the draft_editor custom LLM config and enable the LLM editor in agent options.
    📍In Settings, add a custom LLM configuration named draft_editor pointing to your preferred model, then enable codeact_enable_llm_editor in the agent options.
    Cap compute cost on o1-family models by setting reasoning_effort to a lower tier for less complex tasks.
    📍In Settings › LLM, select an o1-family model and set reasoning_effort to low (or medium/high) to trade off reasoning depth against token cost.
    • ›Adds multi-language UI support, broadening accessibility for non-English practitioners.
    • ›Supports the reasoning_effort parameter for OpenAI o1-family models, giving control over model reasoning depth.
    • ›Introduces a draft_editor named custom LLM config so a separate, dedicated model can handle edit drafts independently of the primary LLM.
    • ›Adds trajectory replay in headless mode, enabling automated re-execution of recorded agent sessions.
    • ›Adds a chat-panel button to download the current agent trajectory for offline review or auditing.
    +1 moreshow less

    • ›Agent now explicitly receives the cloned repo name and path when connecting to a GitHub repository, improving context awareness.
    └──▷ BREAKING ON UPGRADE

    • !The trajectories_path config key is renamed to save_trajectory_path; existing configurations using trajectories_path will break on upgrade.
100. 0.20.0 Jan 13, 2025 · issue -370

     OpenHands 0.20.0 adds a live App tab for interacting with web apps and a conversation info display.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.20.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.20.0

     └──▷ HOW TO FIND IT
     Preview and interact with a web app your agent is building without leaving the OpenHands UI.
     📍In the OpenHands UI, open your conversation and click the App tab (bottom panel) to view and interact with the running web app in real time.
     • ›Adds a new App tab (Beta) that lets users interact directly with the web app running inside OpenHands.
     • ›Displays current conversation info in the bottom-right corner of the UI.
101. 0.19.0 Jan 7, 2025 · issue -370

     OpenHands 0.19.0 adds custom microagents in headless/CLI modes, toggleable function calling, multi-conversation support, and runtime size configuration.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.19.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.19.0

     • ›Supports custom microagents in headless and CLI modes, extending agent customization beyond the UI.
     • ›Enables or disables function calling via user configuration, giving practitioners control over LLM tool-use behavior.
     • ›Adds rate-limit error visibility in the UI and agent state, surfacing provider throttling in real time.
     • ›Introduces multi-conversation feature (behind a feature flag), allowing parallel conversation management.
     • ›Adds runtime size configuration, letting users tune the sandbox compute footprint per session.
     └──▷ BREAKING ON UPGRADE

     • !Developer mode now defaults to storing data on the filesystem instead of in-memory, which changes persistence behavior for existing developer-mode deployments.
102. 0.18.0 Jan 2, 2025 · issue -370

     OpenHands 0.18.0 adds per-repo prompt customization, resizable panels, and server-side settings storage.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.18.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.18.0

     └──▷ HOW TO FIND IT
     Customize the agent's system prompt for a specific repository so it follows project-specific conventions on every run.
     📍In your repository root, create a .openhands directory and add your prompt customization files there. OpenHands will automatically detect and apply them when operating on that repo.
     • ›Adds .openhands directory support for customizing agent prompts on a per-repository basis.
     • ›Introduces a resizable and collapsible panel layout in the UI for a more flexible workspace.
     • ›Enables workspace downloads on mobile and browsers lacking the Directory API.
     • ›Migrates settings storage from browser localStorage to the server API, enabling persistent settings across devices and browsers.
     • ›Adds navbar tooltips for improved UI discoverability.
     └──▷ BREAKING ON UPGRADE

     • !File editing functionality has been removed from the OpenHands UI — workflows that relied on in-UI file editing must use an alternative method.
103. 0.17.0 Dec 26, 2024 · issue -371

     OpenHands 0.17 adds custom PR titles, per-conversation URLs, and a homepage recent-conversation view.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.17.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.17.0

     • ›Supports custom pull request titles when using the GitHub issue resolver.
     • ›Each conversation now gets its own unique URL, enabling direct linking and bookmarking.
     • ›Shows the most recent conversation on the homepage for quick resumption.
     • ›Adds TheAgentCompany evaluation harness for benchmarking agent performance.
     • ›Settings store type is now defined in openhands_config instead of the main config.
     └──▷ BREAKING ON UPGRADE

     • !Settings store type is now defined in openhands_config rather than the main config — configurations relying on the main config for this setting will need to be updated.
104. 0.16.1 Dec 19, 2024 · issue -371

     OpenHands 0.16.1 adds file-by-file download with progress and backend config saving infrastructure.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.16.1 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.16.1

     • ›Adds file-by-file download with progress tracking for workspace files.
     • ›Introduces infrastructure for saving configuration on the backend rather than the frontend.
105. 0.16.0 Dec 18, 2024 · issue -371

     OpenHands 0.16.0 updates GitHub Authentication flow.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.16.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.16.0

     • ›Updates GitHub Authentication integration.
106. 0.15.3 Dec 17, 2024 · issue -371

     OpenHands 0.15.3 raises default max_iterations to 500 and resets turn budget per user interaction

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.15.3 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.15.3

     • ›Adds color coding to the 'Ran a Command' UI indicator based on command return value, making pass/fail status immediately visible.
     • ›Increases default max_iterations to 500, enabling agents to tackle longer, more complex tasks before hitting the iteration limit.
     • ›Measures the turn limit from the last user interaction rather than session start, giving agents a full budget after each user message.
     • ›Persists jwt_secret in the config file so the secret survives service restarts without manual reconfiguration.
107. 0.15.2 Dec 12, 2024 · issue -371

     OpenHands 0.15.2 adds workspace-level custom MicroAgents, resolver code-review requests, and browser observations in chat.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.15.2 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.15.2

     • ›Adds support for Custom MicroAgents placed directly in the connected workspace, enabling project-specific agent behavior without global configuration.
     • ›Enables the resolver to automatically request a code review from the person who initiated it after completing a PR.
     • ›Surfaces browser observations (what the agent sees while web browsing) directly in the chat interface for real-time visibility.
108. 0.15.1 Dec 6, 2024 · issue -371

     OpenHands 0.15.1 adds command-run notifications and multiline message support in headless mode.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.15.1 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.15.1

     • ›Shows a status message in the UI each time the agent executes a command, giving real-time visibility into agent actions.
     • ›Supports multiline user messages, and provides a default user message when running in headless mode.
109. 0.15.0 Dec 4, 2024 · issue -371

     OpenHands 0.15.0 adds SocketIO comms, BrowseURLAction in CodeAct, custom resolver sandboxes, and multi-tab session sharing.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.15.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.15.0

     • ›Switches underlying client-server communication to SocketIO for more robust real-time messaging.
     • ›Adds BrowseURLAction to the CodeAct agent, enabling it to navigate URLs as part of agentic workflows.
     • ›Adds an alignment checker for the browsing agent to verify page-interaction accuracy.
     • ›Supports custom sandbox images for the GitHub issue resolver.
     • ›Adds a microagent to automatically handle npm timeout issues during code execution.
     +2 moreshow less

     • ›Allows multiple browser tabs to connect to and share the same agent session simultaneously.
     • ›Runtimes are no longer kept alive by default, reducing idle resource consumption.
     └──▷ BREAKING ON UPGRADE

     • !Runtimes are no longer kept alive by default — existing deployments that relied on persistent runtimes between sessions will need to reconfigure this behavior explicitly.
110. 0.14.3 Nov 26, 2024 · issue -372

     OpenHands 0.14.3 adds a Push & Create PR button and the commit0 benchmark.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.14.3 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.14.3

     └──▷ HOW TO FIND IT
     After an agent completes its work, push the branch and open a PR without leaving the UI.
     📍In the OpenHands UI, after a session completes, click the Push & Create PR button to push the current branch and create a pull request in your connected repository.
     • ›New Push & Create PR UI button lets users push changes and open a pull request directly from the OpenHands interface.
     • ›Adds the commit0 benchmark for evaluating agent performance.
     • ›Server process now runs at highest system priority, improving responsiveness under load.
111. 0.14.1 Nov 19, 2024 · issue -372

     OpenHands 0.14.1 adds a push-to-GitHub button directly in the chat interface.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.14.1 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.14.1

     └──▷ HOW TO FIND IT
     After completing a coding task in a session, push your changes to GitHub without leaving the chat interface.
     📍In the chat interface, click the 'Push to GitHub' button to push your current changes to the configured GitHub repository.
     • ›Adds a 'Push to GitHub' action button in the chat interface for pushing changes directly from a session.
112. 0.14.0 Nov 15, 2024 · issue -372

     OpenHands 0.14.0 adds an embedded VSCode editor, GitHub issue resolver integration, and universal function-calling shim for non-native LLMs.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.14.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.14.0

     └──▷ HOW TO FIND IT
     Open the embedded VSCode editor from within the OpenHands UI to inspect and edit agent-modified files without leaving the interface.
     📍In the OpenHands UI, open an active session and click the VSCode panel to launch the integrated editor against the running runtime.
     • ›Adds a full VSCode editor directly inside the OpenHands runtime and UI, giving agents and users an integrated code editing experience.
     • ›Integrates the OpenHands resolver into the main repository, enabling automated GitHub issue resolution workflows natively.
     • ›Adds a utility that automatically converts function-calling LLM requests to non-function-calling format, broadening compatible model support.
113. 0.13.1 Nov 12, 2024 · issue -372

     OpenHands 0.13.1 adds workspace media previews and improved GitHub push support.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.13.1 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.13.1

     • ›Supports displaying images, videos, and PDFs directly in the workspace UI.
     • ›Improves pushing changes to GitHub from within a session.
114. 0.13.0 Nov 8, 2024 · issue -372

     OpenHands 0.13.0 adds drag-and-drop image input to chat and a loading indicator for ZIP downloads.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.13.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.13.0

     • ›Supports dragging images directly into the chat input for multimodal interactions.
     • ›Shows a loading indicator when downloading a workspace ZIP file.
     • ›New empty-state design for the chat interface.
115. 0.12.2 Nov 4, 2024 · issue -372

     OpenHands 0.12.2 gives CodeAct native web browsing, adds PostHog analytics, and integrates DiscoveryBench.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.12.2 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.12.2

     • ›Adds PostHog analytics integration for tracking usage and agent behavior.
     • ›Enables CodeAct agent to perform web browsing natively — no longer delegates to a separate BrowsingAgent.
     • ›Adds DiscoveryBench integration for benchmarking OpenHands agents on data-discovery tasks.
116. 0.12.0 Oct 31, 2024 · issue -373

     OpenHands 0.12.0 adds function calling to CodeAct 2.1 and prompt caching for Claude 3.5 Sonnet, hitting 53% on SWE-Bench Verified.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.12.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.12.0

     • ›Adds function calling support to the CodeAct 2.1 agent, boosting benchmark performance to 53% on SWE-Bench Verified and 41.7% on SWE-Bench Lite — the highest score among open-source AI software engineering systems.
     • ›Supports prompt caching for claude-3-5-sonnet-20241022, reducing latency and cost on repeated context.
     • ›Surfaces backend error messages directly in the chat UI so practitioners see failure details without digging through logs.
117. 0.11.0 Oct 22, 2024 · issue -373

     OpenHands 0.11.0 improves LLM-powered agent file editing.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.11.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.11.0

     • ›Improves agent file editing quality using LLM-based refinements.
118. 0.10.0 Oct 17, 2024 · issue -373

     OpenHands 0.10.0 ships a redesigned UI and adds Modal as a new sandbox runtime.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.10.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.10.0

     • ›New OpenHands UI with a redesigned interface for interacting with agents.
     • ›Adds Modal sandbox support as an alternative runtime backend for agent execution.
119. 0.9.8 Oct 3, 2024 · issue -373

     OpenHands 0.9.8 lets you specify a custom config.toml path via command-line arguments.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.9.8 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.9.8

     • ›Supports specifying the config.toml location via command-line arguments, enabling flexible multi-environment deployments.
120. 0.9.5 Sep 26, 2024 · issue -374

     OpenHands 0.9.5 adds more granular startup status messages in the UI.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.9.5 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.9.5

     • ›Displays more granular status messages in the UI during agent startup, giving practitioners better visibility into initialization progress.
121. 0.9.4 Sep 20, 2024 · issue -374

     OpenHands 0.9.4 adds a --version flag to the CLI and reduces Gemini safety thresholds.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.9.4 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.9.4

     • ›Adds --version flag to the OpenHands CLI for quick version inspection.
     • ›Reduces safety thresholds for Gemini models, enabling broader task execution with Gemini backends.
122. 0.9.3 Sep 13, 2024 · issue -374

     OpenHands 0.9.3 adds interactive command support and a redesigned settings modal.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.9.3 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.9.3

     • ›Supports interactive terminal commands, enabling agents to handle prompts that require user input mid-execution.
     • ›Redesigned settings modal with an updated UI for configuring the service.
     • ›Makes prompt caching opt-in rather than enabled by default, giving users explicit control over caching behavior.
     └──▷ BREAKING ON UPGRADE

     • !Prompt caching is no longer enabled by default; users who relied on it must explicitly opt in after upgrading.
123. 0.9.1 Aug 29, 2024 · issue -375

     OpenHands 0.9.1 adds a CLI mode, prompt caching for Sonnet/Haiku, and specialized micro agents for CodeAct.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.9.1 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.9.1

     • ›Adds CLI mode, enabling OpenHands to be driven from the command line without the web UI.
     • ›Adds prompt caching to CodeActAgent for Anthropic Sonnet and Haiku models, reducing latency and token costs on repeated context.
     • ›Introduces micro agents as specializations of CodeAct, allowing targeted agent behaviors for specific tasks.
     • ›Improves model selection UI in settings for easier LLM configuration.
124. 0.9.0 Aug 23, 2024 · issue -375

     OpenHands 0.9.0 adds vision LLM support, a Security Analyzer, async LLM calls, and switches to EventStream Runtime by default.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.9.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.9.0

     • ›Adds vision input support for LLMs with vision capabilities, enabling image-aware agent interactions.
     • ›Adds a Security Analyzer functionality for automated security review workflows.
     • ›Enhances the LLM class with async support for non-blocking model calls.
     • ›Implements copy_to for Runtime, allowing files to be pushed directly into the agent's runtime environment.
     • ›Supports injecting additional dependencies into the OpenHands runtime Docker image at launch.
     +7 moreshow less

     • ›Switches the default runtime to EventStream Runtime.
     • ›Clears conversation history at the start of each new task to avoid context bleed between sessions.
     • ›Adds collapsible resizers in the UI for a more flexible workspace layout.
     • ›Integrates the Aider Benchmark for agent evaluation.
     • ›Agents can now accept per-agent configuration via agent config, enabling fine-grained control.
     • ›Adds warning messages when a config file contains unknown keys, helping catch misconfiguration early.
     • ›Adds error observations to the CodeAct SWE agent so it can recover from execution failures.
     └──▷ BREAKING ON UPGRADE

     • !The project is renamed from OpenDevin to OpenHands — any references to the old name in configs, Docker images, or scripts will need updating.
     • !The default runtime is now EventStream Runtime instead of the previous default — existing setups relying on the old default runtime behavior may behave differently without explicit configuration.
125. 0.8.3 Aug 1, 2024 · issue -375

     OpenHands 0.8.3 adds a UI toggle for agent selection and Dev Container support for GitHub Codespaces.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.8.3 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.8.3

     • ›Adds a UI toggle to enable or disable agent selection (defaults to off, hiding agent selection from end users).
     • ›Adds Dev Container configuration for GitHub Codespaces, enabling one-click cloud development environments.
126. 0.8.2 Jul 27, 2024 · issue -376

     OpenHands 0.8.2 adds headless controller mode and SWE-Bench custom Docker namespace support for eval workflows.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.8.2 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.8.2

     • ›Adds headless_mode for the Controller, enabling programmatic agent runs without a UI session.
     • ›Supports pulling SWE-Bench evaluation environments from a custom Docker namespace.
     • ›Shrinks the runtime image size, reducing pull times and storage overhead.
     └──▷ BREAKING ON UPGRADE

     • !The Monologue agent has been removed and is no longer available as an agent type.
     • !Global config has been removed from the sandbox, agent controller, and related components — configurations previously set globally must now be passed explicitly.
127. 0.8.0 Jul 13, 2024 · issue -376

     OpenHands 0.8.0 adds user confirmation mode, per-agent LLM config, EventStream runtime with browser and Jupyter support, and restores append_file.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.8.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.8.0

     • ›Adds append_file action back to the agent's file-editing toolkit, enabling agents to append content to files without overwriting them.
     • ›Implements user confirmation mode: when enabled, OpenHands requests explicit user confirmation before executing bash or Python code.
     • ›Enables per-agent LLM configuration, allowing each delegated agent to use a distinct LLM config set from the UI.
     • ›Introduces EventStreamRuntime with an agnostic sandbox, adding Jupyter notebook support and browser interaction to the runtime client.
     • ›Adds a WebSocket runtime (od-client-runtime) as a new runtime backend option.
     +3 moreshow less

     • ›Displays real-time build logs for the agnostic sandbox image during construction.
     • ›Deprecates the recall action and search_memory capability, removing them from the agent action surface.
     • ›Removes support for Background Commands from the runtime architecture.
     └──▷ BREAKING ON UPGRADE

     • !Background Commands are no longer supported — any working setup relying on background command execution will break on upgrade.
     • !The recall action and search_memory are deprecated and removed — agents or configurations invoking these will break on upgrade.
128. 0.7.1 Jul 5, 2024 · issue -376

     OpenHands 0.7.1 adds local Ollama model support, CLI session restore, config templates, and DEBUG logging control.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.7.1 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.7.1

     • ›Adds make run-wsl target for running OpenHands under Windows Subsystem for Linux.
     • ›Enables DEBUG-level logging via a config setting, giving operators fine-grained log control without code changes.
     • ›Adds a config template feature to bootstrap new configuration files.
     • ›Adds support for local Ollama models, letting teams run inference entirely on-premises without an external LLM provider.
     • ›Adds optional CLI session restore, allowing interrupted CLI sessions to be resumed.
     +7 moreshow less

     • ›Enables concurrent CLI operation, improving throughput for command-line workflows.
     • ›Removes the MAX_CHARS traffic-control limit, lifting a cap on observation size.
     • ›Allows MAX_ITERATIONS and MAX_BUDGET_PER_TASK to be overridden directly from the web GUI.
     • ›Improves code editing in the CodeAct agent by using diff-based patching for more reliable file edits.
     • ›Removes the Docker exec sandbox backend, consolidating on the SSH-based sandbox.
     • ›Adds automatic LLM retry on internal server errors, improving resilience against transient upstream failures.
     • ›Docker builds for stable releases now also publish a latest tag, simplifying image pulls.
     └──▷ BREAKING ON UPGRADE

     • !The Docker exec sandbox box has been removed; deployments relying on it must migrate to the SSH-based sandbox.
     • !The MAX_CHARS traffic-control setting has been removed; any configuration referencing it will no longer have effect.
     • !Global CLI arguments have been removed; workflows depending on those global args must be updated.
129. 0.7.0 Jun 29, 2024 · issue -377

     OpenHands 0.7.0 adds WebArena, MiniWoB++, GPQA, ToolQA, Gorilla APIBench, and BioCoder benchmarks plus CodeActAgent browser delegation.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch 0.7.0 https://github.com/All-Hands-AI/OpenHands.git
     # already have the repo? check out this version:
     $ git checkout 0.7.0

     • ›Renames the OPENDEVIN_WORKSPACE environment variable to WORKSPACE_BASE across the codebase.
     • ›Adds append_file skill to agentskills, enabling agents to append content to files.
     • ›Adds WebArena and MiniWoB++ benchmark support with related architecture changes for browser-based evaluation.
     • ›Adds GPQA benchmark evaluation support.
     • ›Adds ToolQA benchmark support.
     +8 moreshow less

     • ›Adds Gorilla APIBench benchmark support.
     • ›Adds BioCoder benchmark integration.
     • ›Adds SWE-Bench Docker-based evaluation (SWEBench-docker eval).
     • ›Enables CodeActAgent to delegate browser tasks to BrowsingAgent, allowing the code agent to hand off web interactions to a specialized sub-agent.
     • ›Revamps AgentRejectAction and enables ManagerAgent to handle task rejections gracefully.
     • ›Adds evaluation time-travel capability, allowing benchmark evaluation to target a specific historical version of the codebase.
     • ›Makes plugin sandbox Dockerfile sandbox-agnostic, broadening deployment flexibility.
     • ›Adjusts the stuck-step detection threshold to 3 consecutive identical steps before halting.
     └──▷ BREAKING ON UPGRADE

     • !The OPENDEVIN_WORKSPACE environment variable is renamed to WORKSPACE_BASE; existing configurations referencing OPENDEVIN_WORKSPACE will no longer be recognized.
     • !The github-token config key is removed; configurations using it will no longer work.