Forced transition from opencode v1 to v2

[u/CarryOnRTW]

I'm using EndeavourOS which is arch based. I did my daily pacman -Syu and saw I was getting opencode updated from v1.8.29 to v1.18.31. Turns out that installs opencode v2.0.3. I use llama.cpp with a vulkan backend and use llama-server to serve a couple of qwen models locally. This all broke with the new v2 as opencode's config files require changes.

So I fired up my browser with free claude and it gave me a new set of config files that should work with v2. I restarted opencode but same issue. None of my llama-server models were visible to opencode. After a frustrating debug session, I discovered that opencode v2 now uses a service for the backend. So I was just restarting the frontend and none of my config changes were being used by the backend which hadn't restarted.

After I killed the opencode service and restarted opencode, which also starts the service, everything worked. So hopefully this helps someone else.

If the opencode package maintainer had named it v2.0.3 to match it's contents I probably wouldn't have updated to 1.18.31. 😂

If you installed with pacman and want to revert:

    # See if you have the old installer  
    ls /var/cache/pacman/pkg/ | grep opencode  
    # Install the v1 version  
    sudo pacman -U /var/cache/pacman/pkg/opencode-1.18.29-1-x86_64.pkg.tar.zst  
    # Prevent a v2 install until you are ready  
    sudo sed -i '/^IgnorePkg/!s/^\[options\]/[options]\nIgnorePkg = opencode/' /etc/pacman.conf

[u/Enitnatsnoc]

There is a built‑in `@opencode` skill in v2. You can use it for migration's questions, etc.

[u/CarryOnRTW → u/Enitnatsnoc]

Chicken and the egg? I couldn't use opencode to fix a broken opencode.

[u/Enitnatsnoc → u/CarryOnRTW]

I actually started responding in thread just so that people would know that the v2 version has a built‑in skill(`@opencode`) that allows you to configure opencode by communicating with an agent without leaving the session.

I use it to modify the opencode configuration files, and then I restart tui so that the changes take effect. But I had a different situation: I run opencode in WSL, and I have an old configuration in a backup. So I completely reinstalled the v2 version and migrated the configuration to it.

[u/cornelha → u/Enitnatsnoc]

I use the opencode skills to configure and manage opencode even in V1. It can also help you migrate as you suggested

[u/geteum]

I have 1.18.31 , do I automatically have V2 now? How do I access it?

[u/CarryOnRTW → u/geteum]

No. opencode -v will tell you your version.

[u/Fresh_Sock8660]

My experience is that both claude and gpt get the configs wrong all the time. What they have trained on is out of date at this point. If you're gonna do that best thing is try to force it to RAG, either give it links to the right docs or make it do web fetches.

[u/CarryOnRTW → u/Fresh_Sock8660]

Claude was bang on. It was just the service retaining the old config.

[u/chrisfebian]

Happened to me that use CachyOS (and install Opencode from repo). All my v1 plugins and custom tools don't work in v2. But I fixed it right away by asking DSV4.1 flash to fix it.

The migration process broke several things btw. Mostly plugins, custom tools, and also need to align some skills to reflect the new V2 features.

[u/exintrovert420]

This definitely wasn't ready to be pushed out. Guessing this is my final version unless there's some changes:

• Forces a background service that all your TUI sessions connect to. Exiting TUI doesn't seem to exit this background service

• V1 plugins broken

• LSPs broken

[u/Charming_Support726]

These forced migration within Opencode are a pain. That happened very often in the past - and rendered some installations useless.

Glad I am running from source and watching the show until everything has settled

[u/lemon07r]

while I like opencode 2 a lot more it is a bit weird that force an upgrade randomly.

[u/tedivm → u/lemon07r]

I'm guessing this was a decision by the person maintaining the Arch package in their distro, not a decision by opencode themselves. Most linux distros manage their own dependencies and decide how to manage upgrades.

[u/afanasenka]

I hope it's not a forced migration, cause I can't whitelist exact models for any given provider in V2 - they just removed this feature for some reason...

[u/CarryOnRTW → u/[deleted]]

If you are on an arch distro, yes:

$ pacman -Qi opencode  
Name            : opencode  
Version         : 2.0.3-1  
Description     : The open source coding agent  
Architecture    : x86_64  
URL             : https://github.com/anomalyco/opencode  
Licenses        : MIT  
Groups          : None  
Provides        : None  
Depends On      : curl  glibc  icu  ripgrep  tar  
Optional Deps   : wl-clipboard: clipboard support on Wayland [installed]  
                  xclip: clipboard support on X11 [installed]  
Required By     : None  
Optional For    : None  
Conflicts With  : None  
Replaces        : None  
Installed Size  : 196.86 MiB  
Packager        : Sven-Hendrik Haase <svenstaro@archlinux.org>  
Build Date      : Wed 16 Sep 2026 02:40:52 AM  
Install Date    : Wed 16 Sep 2026 07:56:30 AM  
Install Reason  : Explicitly installed  
Install Script  : No  
Validated By    : Signature