v1.2.10: Sidecar Optimization, SDK Build Improvement

Release Date: 2026-02-20

Minor version update optimizing desktop sidecar startup logic and improving SDK build output.

🎯 One-Sentence Summary

Desktop sidecar is smarter (only starts when not localhost); SDK build directory optimized.

---

✨ Improvements

Desktop Sidecar Optimization

When the default server is localhost, sidecar process is no longer started.

Benefits: Reduces unnecessary process startup, saves resources.

Who benefits: Desktop users using local servers.

---

SDK Build Directory Optimization

SDK now builds to dist/ directory instead of dist/src/.

Benefits: Cleaner package structure, more intuitive import paths.

Who benefits: Developers using OpenCode SDK.

---

📊 Should You Upgrade?

Situation	Recommendation
Developing SDK	✅ Recommended
Using local server	⚪ Optional upgrade
Regular user	⚪ Optional upgrade

---

⬆️ Upgrade Command

opencode upgrade

---

📚 Documentation Update

Custom Tool Name Collision Precedence

Official documentation added a "Tool Name Collision" section, clarifying:

• Custom tools override built-in tools with the same name
• For example: Creating .opencode/tool/bash.ts will replace the built-in bash tool
• If you want to disable a built-in tool instead of overriding, use Permission Configuration

Who benefits: Advanced users who need to customize or restrict built-in tool behavior.

---

📋 Technical Details

Click to expand original Release Notes

Desktop

• Don't spawn sidecar if default is localhost server

SDK

• Build SDK to dist/ instead of dist/src

Thank you to 1 community contributor:

• @rmk40: docs: clarify tool name collision precedence

---

← Back to Changelog