automation: Docs update for OpenHands v1.15.0 release

[all-hands-bot]

Release

• Version: v1.15.0
• Published: 2026-08-21T14:01:34Z
• URL: https://github.com/OpenHands/OpenHands/releases/tag/v1.15.0
• Prerelease: no

Release summary

OpenHands v1.15.0 ships 8 features, 18 bug fixes, 1 performance improvement, 3 documentation fixes, and 7 maintenance changes. Headline user-facing features include: a sidebar Getting Started checklist with a settings toggle, workspace path display in the Files view, automation catalog entries that ship script bundles (not just prompts), an LLM provider-connections UI for local agent-server deployments, a polished automations dashboard with a recommended rail and Add/Import flow, and a conversation overview panel with a unified commits drawer. The release also completes the microagent→skill terminology rename in the frontend, fixes several LLM profile-selection and git-remote-URL parsing bugs, and batches streaming delta events for better UI performance with fast models.

Documentation review checklist

• feat(sidebar): add getting started checklist with settings toggle (PR #16182) — documentation needed; a new onboarding checklist appears in the sidebar with an app-settings toggle to show/hide it. Document this feature in the user guide / onboarding section. Source: feat(sidebar): add getting started checklist with settings toggle OpenHands#16182
• feat: show workspace path in Files view (PR #16362) — documentation needed; the Files view now displays the active workspace path with a copy button. Document this in the Files view / workspace guide. Source: feat: show workspace path in Files view OpenHands#16362
• feat(automations): install a catalog entry that ships a script bundle (PR #16680) — documentation needed; automation catalog entries can now install script bundles (deterministic automations) in addition to prompt presets. This changes the setup flow and should be documented in the automations setup guide. Source: feat(automations): install a catalog entry that ships a script bundle OpenHands#16680
• feat: add LLM provider-connections UI (local agent-server) (PR #16616) — documentation needed; a new Provider Connections panel in LLM settings (local-only, hidden on cloud) lets users manage shared provider credentials across profiles. Document this in the LLM configuration / local setup guide. Source: feat: add LLM provider-connections UI (local agent-server) OpenHands#16616
• feat: polish automations dashboard, recommended rail, and Add/Import flow (PR #16688) — probably no documentation change; this is a UI polish pass on existing automations surfaces with no new user-facing concept. Source: feat: polish automations dashboard, recommended rail, and Add/Import flow OpenHands#16688
• feat(conversation): add overview panel and unified commits drawer (PR #16230) — documentation needed; a new conversation overview panel shows project context (workspace, git state, resources) with a unified commits drawer. Document this in the conversation UI guide. Source: feat(conversation): add overview panel and unified commits drawer OpenHands#16230
• feat: send template provenance for versioned setup entries (PR #16458) — probably no documentation change; this is backend metadata plumbing for automation setup with no direct user-facing surface. Source: feat: send template provenance for versioned setup entries OpenHands#16458
• feat: instrument onboarding checklist link clicks (PR #16777) — probably no documentation change; this adds telemetry/analytics instrumentation to onboarding checklist links. Source: feat: instrument onboarding checklist link clicks OpenHands#16777
• fix: prevent silent agent profile downgrade (PR #16523) — needs maintainer confirmation; changes error-handling behavior when agent profile discovery fails (conversation creation now stops instead of silently using stale global settings). Determine whether documented error/recovery behavior needs updating. Source: fix: prevent silent agent profile downgrade OpenHands#16523
• fix: honor the home LLM dropdown selection over an agent profile's pinned LLM (PR #16671) — needs maintainer confirmation; changes LLM selection precedence so the home dropdown takes priority over a profile's pinned LLM. Determine whether documented LLM configuration behavior needs updating. Source: fix: honor the home LLM dropdown selection over an agent profile's pinned LLM OpenHands#16671
• fix: do not silently persist ACP model picks to agent_settings when profile discovery fails (PR #16701) — needs maintainer confirmation; related to #16523, prevents silent persistence of model picks on profile discovery failure. Source: fix: do not silently persist ACP model picks to agent_settings when profile discovery fails OpenHands#16701
• fix: unsandbox the PDF preview iframe so the built-in viewer renders (PR #16702) — probably no documentation change; bug fix that restores PDF preview rendering. Source: fix: unsandbox the PDF preview iframe so the built-in viewer renders OpenHands#16702
• fix: normalize trailing slash in git remote URLs (PR #16536) — probably no documentation change; bug fix for URL parsing with no user-facing behavior change beyond fixing the bug. Source: fix: normalize trailing slash in git remote URLs OpenHands#16536
• fix(git): stop reading a remote URL's port as part of the repository path (PR #16723) — probably no documentation change; bug fix for SSH remote URL port parsing. Source: fix(git): stop reading a remote URL's port as part of the repository path OpenHands#16723
• fix: reconcile non-native tool-call streamed <function=...> XML delta (PR #16220) — probably no documentation change; bug fix for rendering of non-native tool-call streamed XML. Source: fix: reconcile non-native tool-call streamed <function=...> XML delta OpenHands#16220
• perf: batch StreamingDeltaEvents so the UI keeps up with fast models (PR #16164) — probably no documentation change; internal performance optimization with no user-facing configuration surface. Source: perf: batch StreamingDeltaEvents so the UI keeps up with fast models OpenHands#16164
• fix(scripts): use 127.0.0.1 for remaining localhost service URLs (PR #16409) — probably no documentation change; dev-script fix for IPv4-only binds. Source: fix(scripts): use 127.0.0.1 for remaining localhost service URLs OpenHands#16409
• refactor: finish the microagent→skill rename in the frontend (PR #16672) — documentation needed; completes the terminology rename from "microagent" to "skill" across the frontend. Any docs still referencing "microagent" should be updated to "skill" for consistency. Source: refactor: finish the microagent→skill rename in the frontend OpenHands#16672
• refactor: serve the automation interface from the manifest alone (PR #16676) — probably no documentation change; internal architectural refactor removing fallback paths. Source: refactor: serve the automation interface from the manifest alone OpenHands#16676
• chore: bump openhands-automation to 1.8.0 (PR #16712) — probably no documentation change; version bump that ships the git sync backend. Source: chore: bump openhands-automation to 1.8.0 OpenHands#16712

Pull request review

• feat(sidebar): add getting started checklist with settings toggle OpenHands#16182 — Adds a sidebar Getting Started onboarding checklist (6 items) with an App Settings toggle to show/hide it. New user-facing UI surface; the checklist items include links to docs/onboarding pages. Docs impact: new onboarding checklist feature needs user-facing documentation.
• feat: show workspace path in Files view OpenHands#16362 — Adds a workspace-path component to the Files view showing the current working directory with a copy button. Docs impact: new Files view feature; document in workspace/Files guide.
• feat(automations): install a catalog entry that ships a script bundle OpenHands#16680 — Enables catalog entries to install script bundles (tar.gz) for deterministic automations, not just prompt presets. Adds manifest validation, bundle packaging, and multi-repository field support. Docs impact: new automation setup capability; document in automations setup guide.
• feat: add LLM provider-connections UI (local agent-server) OpenHands#16616 — Adds a Provider Connections panel in LLM settings (local-only, hidden on cloud) for sharing credentials across profiles. Includes a provider-connection selector in the profile editor. Docs impact: new LLM configuration feature for local deployments; document in LLM settings/local setup guide.
• feat: polish automations dashboard, recommended rail, and Add/Import flow OpenHands#16688 — UI polish of the automations dashboard, recommended rail, and Add/Import flow. No new user-facing concepts. Docs impact: none identified.
• feat(conversation): add overview panel and unified commits drawer OpenHands#16230 — Adds a conversation overview panel showing project context (workspace, git state, resources, skills) with a unified commits drawer, file diffs, and git actions. Major user-facing feature. Docs impact: new conversation UI; document in conversation guide.
• feat: send template provenance for versioned setup entries OpenHands#16458 — Sends template provenance metadata (id, version, config) to automation preset endpoints. Backend plumbing. Docs impact: none identified.
• feat: instrument onboarding checklist link clicks OpenHands#16777 — Instruments onboarding checklist link clicks with telemetry events. Analytics only. Docs impact: none identified.
• fix: prevent silent agent profile downgrade OpenHands#16523 — Prevents conversation creation from proceeding through stale global agent_settings after profile discovery fails. Changes error-handling behavior. Docs impact: needs maintainer confirmation on whether documented behavior changes.
• fix: honor the home LLM dropdown selection over an agent profile's pinned LLM OpenHands#16671 — Changes LLM selection so the home dropdown takes priority over a profile's pinned LLM. Docs impact: needs maintainer confirmation on whether documented LLM configuration behavior changes.
• fix: unsandbox the PDF preview iframe so the built-in viewer renders OpenHands#16702 — Removes iframe sandbox on PDF preview so the built-in viewer renders. Bug fix. Docs impact: none identified.
• fix: do not silently persist ACP model picks to agent_settings when profile discovery fails OpenHands#16701 — Prevents silent persistence of ACP model picks to agent_settings when profile discovery fails. Related to #16523. Docs impact: needs maintainer confirmation.
• fix: normalize trailing slash in git remote URLs OpenHands#16536 — Trims trailing URL separators before applying .git suffix removal in parseGitRemoteUrl. Bug fix. Docs impact: none identified.
• fix(git): stop reading a remote URL's port as part of the repository path OpenHands#16723 — Fixes SSH remote URL port parsing so the port is not read as part of the repository path. Bug fix. Docs impact: none identified.
• fix: reconcile non-native tool-call streamed <function=...> XML delta OpenHands#16220 — Fixes rendering of non-native tool-call streamed <function=...> XML delta by scoping the streamed-XML marker fallback to the same sender. Bug fix. Docs impact: none identified.
• perf: batch StreamingDeltaEvents so the UI keeps up with fast models OpenHands#16164 — Batches StreamingDeltaEvents via a streaming-delta-batcher to keep the UI responsive with fast models. Performance optimization. Docs impact: none identified.
• fix(scripts): use 127.0.0.1 for remaining localhost service URLs OpenHands#16409 — Switches remaining localhost service URLs to 127.0.0.1 in dev scripts. Dev tooling fix. Docs impact: none identified.
• refactor: finish the microagent→skill rename in the frontend OpenHands#16672 — Completes the microagent→skill rename in the frontend, removing all legacy terminology and fallback shims. Docs impact: ensure documentation consistently uses "skill" terminology, not "microagent."
• refactor: serve the automation interface from the manifest alone OpenHands#16676 — Serves the automation interface from the manifest alone, removing fallback paths. Internal refactor. Docs impact: none identified.
• chore: bump openhands-automation to 1.8.0 OpenHands#16712 — Bumps openhands-automation to 1.8.0, shipping the git sync backend. Version bump. Docs impact: none identified.

Human testing required

• Sidebar Getting Started checklist (PR #16182): Open the sidebar in a fresh workspace. Verify the Getting Started checklist appears with its items. Toggle it off in App Settings and verify it hides. Toggle it back on and verify it reappears. Expected: checklist is visible by default, toggles persist across sessions.
• Workspace path in Files view (PR #16362): Open the Files tab. Verify the workspace path is displayed. Click the copy button and paste into a text field. Expected: the full workspace path is shown and copies correctly.
• Automation catalog script bundle install (PR #16680): From the automations dashboard, install a catalog entry that ships a script bundle (not a prompt). Verify the automation is created and runs. Expected: script-bundle automation installs and executes successfully.
• LLM provider connections UI (PR #16616): On a local agent-server deployment, open LLM settings. Verify the Provider Connections panel is visible. Create a provider connection, link it to a profile, and verify the inline API key/base URL fields are hidden. Expected: provider connection is created, linked, and credentials are reused. On cloud, verify the panel is hidden.
• Conversation overview panel (PR #16230): Open a conversation with git commits and uncommitted changes. Verify the overview panel shows project context, git state, and resources. Open the commits drawer. Expected: overview panel and commits drawer display correct information.
• Agent profile downgrade prevention (PR #16523): Simulate an agent profile discovery failure. Verify conversation creation does not proceed with stale global settings. Expected: an error is shown instead of silently starting the wrong agent.
• Home LLM dropdown priority (PR #16671): Select an LLM in the home dropdown that differs from the active agent profile's pinned LLM. Start a conversation. Expected: the home dropdown selection is used, not the profile's pinned LLM.
• Microagent→skill terminology (PR #16672): Search the docs site for any remaining references to "microagent" or "microagents." Expected: all references should use "skill" or "skills" terminology.

Suggested documentation locations

• User guide / onboarding section: Document the new sidebar Getting Started checklist and its settings toggle (PR #16182).
• Files view / workspace guide: Document the workspace path display and copy button (PR #16362).
• Automations setup guide: Document catalog entries that ship script bundles and the multi-repository field (PR #16680).
• LLM settings / local setup guide: Document the Provider Connections panel for managing shared credentials (PR #16616).
• Conversation UI guide: Document the conversation overview panel, unified commits drawer, and git actions (PR #16230).
• Terminology audit across all docs: Update any remaining "microagent"/"microagents" references to "skill"/"skills" (PR #16672).
• LLM configuration guide: Needs maintainer triage for the home dropdown priority change and profile discovery failure behavior (PRs #16671, #16523, #16701).

Source links

• https://github.com/OpenHands/OpenHands/releases/tag/v1.15.0
• feat(sidebar): add getting started checklist with settings toggle OpenHands#16182
• feat: show workspace path in Files view OpenHands#16362
• feat(automations): install a catalog entry that ships a script bundle OpenHands#16680
• feat: add LLM provider-connections UI (local agent-server) OpenHands#16616
• feat: polish automations dashboard, recommended rail, and Add/Import flow OpenHands#16688
• feat(conversation): add overview panel and unified commits drawer OpenHands#16230
• feat: send template provenance for versioned setup entries OpenHands#16458
• feat: instrument onboarding checklist link clicks OpenHands#16777
• fix: prevent silent agent profile downgrade OpenHands#16523
• fix: honor the home LLM dropdown selection over an agent profile's pinned LLM OpenHands#16671
• fix: unsandbox the PDF preview iframe so the built-in viewer renders OpenHands#16702
• fix: do not silently persist ACP model picks to agent_settings when profile discovery fails OpenHands#16701
• fix: normalize trailing slash in git remote URLs OpenHands#16536
• fix(git): stop reading a remote URL's port as part of the repository path OpenHands#16723
• fix: reconcile non-native tool-call streamed <function=...> XML delta OpenHands#16220
• perf: batch StreamingDeltaEvents so the UI keeps up with fast models OpenHands#16164
• fix(scripts): use 127.0.0.1 for remaining localhost service URLs OpenHands#16409
• refactor: finish the microagent→skill rename in the frontend OpenHands#16672
• refactor: serve the automation interface from the manifest alone OpenHands#16676
• chore: bump openhands-automation to 1.8.0 OpenHands#16712

This issue was created by an AI agent (OpenHands) on behalf of the user.

[all-hands-bot]

A draft documentation PR is ready for human review: #747

This comment was created by an AI agent (OpenHands) on behalf of the user.