Opencode doesn't start after installing caveman

[adrianbaena]

What happen

❯ node bin/install.js --only opencode
🪨 caveman installer
  JuliusBrussee/caveman

→ opencode detected
  installed: /home/<user>/.config/opencode/plugins/caveman
  installed: /home/<user>/.config/opencode/commands/caveman.md
  installed: /home/<user>/.config/opencode/commands/caveman-commit.md
  installed: /home/<user>/.config/opencode/commands/caveman-review.md
  installed: /home/<user>/.config/opencode/commands/caveman-compress.md
  installed: /home/<user>/.config/opencode/commands/caveman-stats.md
  installed: /home/<user>/.config/opencode/commands/caveman-help.md
  installed: /home/<user>/.config/opencode/agents/cavecrew-investigator.md
  installed: /home/<user>/.config/opencode/agents/cavecrew-builder.md
  installed: /home/<user>/.config/opencode/agents/cavecrew-reviewer.md
  installed: /home/<user>/.config/opencode/skills/caveman/
  installed: /home/<user>/.config/opencode/skills/caveman-commit/
  installed: /home/<user>/.config/opencode/skills/caveman-review/
  installed: /home/<user>/.config/opencode/skills/caveman-help/
  installed: /home/<user>/.config/opencode/skills/caveman-stats/
  installed: /home/<user>/.config/opencode/skills/caveman-compress/
  installed: /home/<user>/.config/opencode/skills/cavecrew/
  installed: /home/<user>/.config/opencode/AGENTS.md
  registered caveman-shrink MCP server
  patched: /home/<user>/.config/opencode/opencode.json

  tip: re-run inside a repo with --all (or --with-init) to also write per-repo
       Cursor/Windsurf/Cline/Copilot/AGENTS.md rule files.

🪨 done
  installed:
    • opencode

  start any session and say 'caveman mode', or run /caveman in Claude Code
  uninstall: npx -y github:JuliusBrussee/caveman -- --uninstall

❯ opencode
Error: 4 of 5 requests failed: Unexpected server error. Check server logs for details.
Affected startup requests: config.providers, provider.list, app.agents, config.get
    at bO (/$bunfs/root/chunk-whppmhdm.js:470:117)
    at <anonymous> (/$bunfs/root/chunk-whppmhdm.js:470:5550)
    at processTicksAndRejections (native:7:39)

With DEBUG logs it's the same...

❯ opencode --log-level DEBUG --print-logs
INFO  2026-05-21T19:49:25 +267ms service=default version=1.15.7 args=["--log-level","DEBUG","--print-logs"] process_role=main run_id=8bb1ef5b-873a-49ee-aee2-513a1e879d5f opencode
Error: 4 of 5 requests failed: Unexpected server error. Check server logs for details.
Affected startup requests: config.providers, provider.list, app.agents, config.get
    at bO (/$bunfs/root/chunk-whppmhdm.js:470:117)
    at <anonymous> (/$bunfs/root/chunk-whppmhdm.js:470:5550)
    at processTicksAndRejections (native:7:39)

Expected
I should opencode start, I have uninstalled caveman and Opencode starts working like charm.

Before/after example
n/a

Platform

• Claude Code
• Codex
• Other: opencode

Version / install method
v1.8.2 / manually cloning repository and executing node bin/install.js --only opencode (I've patched manually the missing src/plugins/opencode/commands/caveman-compress.md, otherwise caveman can't be installed)

[kjohnsen]

Exact same thing here

[alaa-alghazouli]

I've submitted a PR that fixes this! This issue was caused by the incorrect tools schema in the agent configuration files, which prevented Opencode from starting up.

PR: #452

[adrianbaena]

I've solved all the problems with caveman + opencode applying these two PRs to the cloned repo before installing caveman:

#380
#434

Then do:

node /path/to/bin/install.js --uninstall

And finally install it again:

node /path/to/bin/install.js --only opencode

And you are done!