# OpenCode 2 Migration Guide: Breaking Changes to Plugins, Server API, and TUI Config

DevFeed: [OpenCode 2 Migration Guide: Breaking Changes to Plugins, Server API, and TUI Config](<https://devfeed.tech/articles/opencode-2-how-to-upgrade-from-v1-without-breaking-your-setup-85716.md>)

Original publisher: [Read original article](<https://www.developersdigest.tech/blog/opencode-2-upgrade-migrate-v1-config-plugins-2026>)

Author: Developers Digest

Published: 2026-10-11T00:00:00Z

Content type: tutorial

Language: en

Sources: [Developers Digest](<https://devfeed.tech/sources/developers-digest.md>)

Topics: [upgrade](<https://devfeed.tech/topics/upgrade.md>)

Tags: [ai-coding-tools](<https://devfeed.tech/tags/ai-coding-tools.md>), [api](<https://devfeed.tech/tags/api.md>), [config](<https://devfeed.tech/tags/config.md>), [guide](<https://devfeed.tech/tags/guide.md>), [how-to](<https://devfeed.tech/tags/how-to.md>), [major](<https://devfeed.tech/tags/major.md>), [migration](<https://devfeed.tech/tags/migration.md>), [migration-guide](<https://devfeed.tech/tags/migration-guide.md>), [news](<https://devfeed.tech/tags/news.md>), [opencode](<https://devfeed.tech/tags/opencode.md>), [setup](<https://devfeed.tech/tags/setup.md>), [upgrade](<https://devfeed.tech/tags/upgrade.md>)

## AI overview

OpenCode 1.19.0 adds `opencode upgrade --major` for upgrading to OpenCode 2. The migration guide covers changes to plugins, the server API, and TUI configuration, along with what carries over and a checklist for upgrading.

## Source excerpt

OpenCode 1.19.0 now ships `opencode upgrade --major` to move you to OpenCode 2. What the migration guide says breaks (plugins, server API, TUI config), what carries over, and a safe Monday checklist.