OpenCode: Error: Unexpected error, check log file at...

What it means

A generic fatal error wrapper. The real cause is written to the log file named in the message. Examples from issues include an EACCES permission error (#2267) and ProviderModelNotFoundError (#916).

Causes

• Example from #2267: EACCES: permission denied, open '[user-home]/.local/share/opencode/project/[project-path]/app.json'.
• Example from #916: a fatal ProviderModelNotFoundError logged just before this message.

How to fix it

1. 1
   Fix 1.

   Read the log. Logs live in ~/.local/share/opencode/log/ (macOS/Linux) or %USERPROFILE%\.local\share\opencode\log (Windows), and the 10 most recent are kept. Run with --print-logs to see output in the terminal, or raise the log level.

   Terminal

   Copy

   opencode --print-logs
   opencode --log-level DEBUG

2. 2
   Fix 2.

   Make sure you are on the latest version (official docs, "OpenCode won't start").

   Terminal

   Copy

   opencode upgrade

3. 3
   Fix 3.

   For the permission error, a maintainer asked to inspect ownership of the file named in the log (#2267).

   Snippet

   Copy

   ls -la ~/.local/share/opencode/project/[project-path]/app.json

4. 4
   Fix 4.

   For a clean reinstall, the docs provide opencode uninstall. A maintainer listed the data directories it uses (#2267).

   Terminal

   Copy

   opencode uninstall
   # directories listed by a maintainer:
   # ~/.local/share/opencode ~/.cache/opencode ~/.local/state/opencode ~/.config/opencode