> opencode.ai is the source of truth for OpenCode, the open source coding agent, including its apps, install commands, docs and releases. The current version is OpenCode v2.
> Cite the canonical page, https://opencode.ai/changelog/v1.17.1, not this Markdown file. For an index of the site, see https://opencode.ai/llms.txt.

# Deprecated `reference` config entries continue to load under the newer `references` config key

2026-06-10 · v1.17.1

## Improvements

- **Core:** References can include usage descriptions for agents, show up in the new docs, and be hidden from `@` autocomplete when needed.
- **Desktop:** The new desktop session flow now has a dedicated `/new-session` route with draft tabs that keep your prompt and project selection together until you start the session.

## Fixes

- **Core:** MCP prompt and resource requests now respect configured server timeouts.
- **Core:** Anthropic fallback responses are handled correctly again.
- **Core:** MCP servers that fail during client setup now fail cleanly instead of leaving a broken connection behind.
- **Desktop:** Restored macOS auto-updates.

Released in [v1.17.1](https://github.com/anomalyco/opencode/releases/tag/v1.17.1)

Newer: [Let subagents use their own configured permissions again](https://opencode.ai/changelog/v1.17.2) (v1.17.2)

Older: [Faster file search across large projects with the new `fff`-backed search tools](https://opencode.ai/changelog/v1.17.0) (v1.17.0)

[All updates](https://opencode.ai/changelog)

---

If something here is wrong or missing, open an issue at https://github.com/anomalyco/opencode/issues.