automation: Docs update for OpenHands v1.14.0 release

[all-hands-bot]

Release

• Version: v1.14.0
• Published: 2026-08-17T21:41:36Z
• URL: https://github.com/OpenHands/OpenHands/releases/tag/v1.14.0
• Prerelease: no

Release summary

OpenHands v1.14.0 ships four features, five bug fixes, one documentation change, and five maintenance/CI changes. Feature highlights: the Canvas now presents structured error outcomes; LLM profiles are validated before saving; a new Git Sync page was added under Automations; and the Canvas default model was changed to OpenHands Kimi K3 (tagged free). Bug fixes address onboarding provider preselection, backend scope in conversation links, a dev-only VITE_BACKEND_BASE_URL issue, local responder URL derivation, and the cloud Files tab file tree. The full changelog compares v1.13.0...v1.14.0.

Documentation review checklist

• feat(canvas): present structured error outcomes — documentation needed; the error UI now shows structured classifications (e.g. recoverable/auth vs internal) with distinct banners. Recommend reviewing openhands/usage/agent-canvas/troubleshooting.mdx and any error-handling content to describe the new structured error outcomes. Source: feat(canvas): present structured error outcomes OpenHands#16231
• feat: add LLM pre-flight validation to prevent saving misconfigured profiles — documentation needed; profiles are now validated before saving on supported backends, and invalid saves are blocked with the backend error (older backends returning 404 proceed with the normal save). Recommend documenting this behavior in openhands/usage/agent-canvas/llm-profiles.mdx and/or openhands/usage/settings/llm-settings.mdx. Source: feat: add LLM pre-flight validation to prevent saving misconfigured profiles OpenHands#16417
• feat(automations): add a Git Sync page — needs maintainer confirmation; a new page at /automations/git-sync mirrors automations to a git repo. The PR body states the UI depends on the automation service backend (feat: sync automations to a git repository automation#327) which was "not released yet" at PR time, so confirm whether the git sync backend is available in this release before documenting. If available, recommend a new section/page under openhands/usage/agent-canvas/managing-automations.mdx or openhands/usage/automations/. Source: feat(automations): add a Git Sync page OpenHands#16521
• feat: set Canvas default model to Kimi K3 and tag it free — documentation needed; the default model was changed to openhands/kimi-k3 and tagged as a free OpenHands model. Note: PR #16531 (also in this release) set the onboarding default to openhands/glm-5.2, while this PR sets DEFAULT_SETTINGS.llm_model and the onboarding default to openhands/kimi-k3 — confirm the effective shipped default before updating docs. Recommend updating default-model references in openhands/usage/llms/openhands-llms.mdx, openhands/usage/agent-canvas/llm-profiles.mdx, and openhands/usage/agent-canvas/first-time-setup.mdx. Source: feat: set Canvas default model to Kimi K3 and tag it free OpenHands#16657
• fix(onboarding): preselect OpenHands LLM provider after picking OpenHands agent — probably no documentation change; this bug fix aligns the onboarding LLM default with the selected OpenHands provider (behavior now matches existing DEFAULT_SETTINGS). Interacts with the default-model change in #16657. Source: fix(onboarding): preselect OpenHands LLM provider after picking OpenHands agent OpenHands#16531
• fix: preserve backend scope in conversation links — probably no documentation change; internal fix ensuring sidebar/start-task conversation links carry backend scope in multi-backend setups. Source: fix: preserve backend scope in conversation links OpenHands#16091
• fix(dev): stop baking absolute VITE_BACKEND_BASE_URL in npm run dev — probably no documentation change; dev-only build fix. Source: fix(dev): stop baking absolute VITE_BACKEND_BASE_URL in npm run dev OpenHands#16605
• fix(automations): set local responder URL from browser origin — probably no documentation change; responder URL is now derived from window.location.origin instead of falling back to localhost:8000. A maintainer may glance at openhands/usage/agent-canvas/managing-automations.mdx if it describes local responder setup. Source: fix(automations): set local responder URL from browser origin OpenHands#16332
• fix: show full workspace file tree in Files tab on cloud backends — probably no documentation change; bug fix restoring the expected full file tree on cloud. Source: fix: show full workspace file tree in Files tab on cloud backends (OHE-3053) OpenHands#16344
• docs(agents): add a repository map clarifying what belongs where — probably no documentation change for the docs site; this updates AGENTS.md in the source repo (developer guidance), not user-facing docs. Source: docs(agents): add a repository map clarifying what belongs where OpenHands#16612
• ci: remove broken QA Changes workflow — probably no documentation change. Source: ci: remove broken QA Changes workflow OpenHands#16549
• ci: re-run PR description check when new commits are pushed — probably no documentation change. Source: ci: re-run PR description check when new commits are pushed OpenHands#16607
• chore: remove unreachable frontend modules and their tests — probably no documentation change. Source: chore: remove unreachable frontend modules and their tests OpenHands#16606
• ci: run PR description check on draft PRs — probably no documentation change. Source: ci: run PR description check on draft PRs OpenHands#16547
• test: capture Docker E2E container logs — probably no documentation change. Source: test: capture Docker E2E container logs OpenHands#16660

Pull request review

• feat(canvas): present structured error outcomes OpenHands#16231 — Changes error display to structured outcomes (auth vs internal classifications) via error-message-banner.tsx, error-handler.ts, and websocket error handling. User-facing error presentation changed; troubleshooting/error docs may need updating.
• feat: add LLM pre-flight validation to prevent saving misconfigured profiles OpenHands#16417 — Adds pre-save validation in profiles-service.api.ts and llm-settings-local-view.tsx using ProfilesClient.validateProfile; invalid saves are blocked with the backend error, with a validating state on the save button. New user-facing profile-save behavior worth documenting.
• feat(automations): add a Git Sync page OpenHands#16521 — Adds a full Git Sync UI (/automations/git-sync) with status, config form, and Sync now button, plus AutomationService methods. PR body notes the feature requires the automation service backend from feat: sync automations to a git repository automation#327, which was not released at PR time; availability in this release needs maintainer confirmation.
• feat: set Canvas default model to Kimi K3 and tag it free OpenHands#16657 — Changes DEFAULT_SETTINGS.llm_model, the onboarding default (ONBOARDING_DEFAULT_LLM_MODEL), and FREE_OPENHANDS_MODELS to openhands/kimi-k3. Updates specs/llm-defaults.md. Default-model docs should be updated; effective default needs confirmation against #16531.
• fix(onboarding): preselect OpenHands LLM provider after picking OpenHands agent OpenHands#16531 — Changes the onboarding LLM default to openhands/glm-5.2 so the provider stays on OpenHands after selecting the OpenHands agent. Bug fix aligning behavior with DEFAULT_SETTINGS; no docs impact expected beyond the default-model question above.
• fix: preserve backend scope in conversation links OpenHands#16091 — Adds backend scope (backend/org query params) to sidebar conversation and start-task links via url-selection.ts/use-task-polling.ts. Internal URL handling fix; no docs impact found.
• fix(dev): stop baking absolute VITE_BACKEND_BASE_URL in npm run dev OpenHands#16605 — Dev-only VITE_BACKEND_BASE_URL build fix; no docs impact found.
• fix(automations): set local responder URL from browser origin OpenHands#16332 — Derives OPENHANDS_URL from window.location.origin before local responder setup and preserves existing values. Behavior fix for responder links; no docs impact expected.
• fix: show full workspace file tree in Files tab on cloud backends (OHE-3053) OpenHands#16344 — Cloud Files tab now lists the full workspace tree via a new listCloudConversationFiles endpoint instead of deriving from git status. Bug fix restoring expected behavior; no docs impact found.
• docs(agents): add a repository map clarifying what belongs where OpenHands#16612 — Adds a "Repository Map — what belongs where" section to AGENTS.md in the source repo. Developer guidance, not user-facing docs; no docs-site impact found.

Human testing required

• Git Sync page availability and function — with the automation service git sync backend available, open /automations/git-sync, configure a repo/branch/path, create an automation, and press Sync now; expected: pending changes drop to 0 and the last synced commit appears in the target repo (per the PR body's test steps). Confirm whether the backend feature is actually available in this release before relying on this.
• LLM pre-flight validation — in local Agent Canvas, open Settings → LLM Profiles, enter an invalid profile, and save; expected: on a supported backend the save is blocked with the backend error and does not save, while on an older backend returning 404 the normal save proceeds (per the PR body's "How to Test").
• Effective default model — start first-run onboarding and select the OpenHands agent; expected: the LLM setup step defaults to the OpenHands provider with the shipped default model. Confirm whether the effective default is openhands/kimi-k3 (per #16657) given #16531 set the onboarding default to openhands/glm-5.2, and confirm the model is tagged as free.
• Structured error outcomes — trigger a recoverable (auth) error and an internal error during a conversation; expected: the error banner shows the appropriate structured outcome (warning icon for auth, error icon for internal) per the PR screenshots.

Suggested documentation locations

• openhands/usage/agent-canvas/troubleshooting.mdx — for structured error outcomes (#16231); review whether error/troubleshooting content should describe the new auth vs internal error banners.
• openhands/usage/agent-canvas/llm-profiles.mdx and openhands/usage/settings/llm-settings.mdx — for LLM pre-flight validation (#16417); document that profiles are validated before saving on supported backends.
• openhands/usage/agent-canvas/managing-automations.mdx (or a new page under openhands/usage/automations/) — for the Git Sync page (#16521); pending maintainer confirmation of backend availability.
• openhands/usage/llms/openhands-llms.mdx, openhands/usage/agent-canvas/llm-profiles.mdx, and openhands/usage/agent-canvas/first-time-setup.mdx — for the default-model change to Kimi K3 (#16657); update default-model references after confirming the effective shipped default.

Source links

• https://github.com/OpenHands/OpenHands/releases/tag/v1.14.0
• feat(canvas): present structured error outcomes OpenHands#16231
• feat: add LLM pre-flight validation to prevent saving misconfigured profiles OpenHands#16417
• feat(automations): add a Git Sync page OpenHands#16521
• feat: set Canvas default model to Kimi K3 and tag it free OpenHands#16657
• fix(onboarding): preselect OpenHands LLM provider after picking OpenHands agent OpenHands#16531
• fix: preserve backend scope in conversation links OpenHands#16091
• fix(dev): stop baking absolute VITE_BACKEND_BASE_URL in npm run dev OpenHands#16605
• fix(automations): set local responder URL from browser origin OpenHands#16332
• fix: show full workspace file tree in Files tab on cloud backends (OHE-3053) OpenHands#16344
• docs(agents): add a repository map clarifying what belongs where OpenHands#16612
• ci: remove broken QA Changes workflow OpenHands#16549
• ci: re-run PR description check when new commits are pushed OpenHands#16607
• chore: remove unreachable frontend modules and their tests OpenHands#16606
• ci: run PR description check on draft PRs OpenHands#16547
• test: capture Docker E2E container logs OpenHands#16660

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: #734

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