FIX: If you are seeing {"error":"Web UI is temporarily unavailable."} after upgrading like me

[Richard-Sees]

Users upgrading from v0.1.0 (or earlier) expect mimo serve to continue launching the web UI. Instead, they receive {"error":"Web UI is temporarily unavailable."} with no indication that the web interface has moved to opencode web. This makes it appear as though the application is broken when it's actually a workflow/documentation change. Consider:

Mentioning the new command in the 503 response.

Printing a console message such as:

The Web UI has moved.
Launch it with:
opencode web
Calling this out prominently in the release notes and migration guide.

If this was already listed elsewhere, let me know - but I spent upwards of an hour trying to find it listed somewhere, and even having the help of other AI. Remember everyone, this is a fork of opencode - so this makes sense now. But on the positive side - looks like we can easily see the opencode free models now also without editing the config.

[Richard-Sees]

There is more information I want to add if you're trying to get opencode to pull mimo.

* it's important to understand that both opencode web and mimo serve will COMPETE for port 4096.

• you need to FIRST launch mimo serve - that way it always gets port 4096.
• next you need to launch opencode web - it will get a randomized port, OR, you can set it. I will suggest a workaround at the end to ensure you can install opencode web as a pwa if you wish.
• once you have both completed in your terminal, go to the opencode web app and go to settings
• settings > server > add server
• point the server to your localhost at port 4096 or whatever port you decided to use for Mimo
• you can name it, set it as default, but make sure you hit that checkmark to attempt to load it.
• if you have issues, I suggest you go in this order: close the browser or tab with opencode web, relaunch from the opencode web port, and see if you can then view it > if not, close opencode web > relaunch opencode web. Hopefully, especially if set to default, you will automatically see your mimo setup including options for build, plan, compose, and any projects to the left!

---

potential launch option if you are on linux:

#!/bin/bash

• Start MiMo server on default port 4096
  mimo serve &

• Give MiMo time to initialize (you can use a larger number if you feel the need)
  sleep 3

• Start OpenCode Web on a fixed port
  opencode web --port 4097

pwa then points to: http://127.0.0.1:4097 for the set opencode web...you can update to whatever port is available if 4097 is taken.