First launch can stall on project .opencode dependency install

[Seigiard]

Description

On the first OpenCode launch in a fresh git worktree containing .opencode/skills, the TUI stayed completely blank and could not accept input. The OpenCode process remained alive.

The last logs for that run were the config paths loaded during bootstrapping; the usual LSP and formatter initialization logs never appeared. During the stall, OpenCode generated .opencode/package.json and node_modules, then wrote .opencode/package-lock.json 61 seconds after bootstrap began.

opencode --pure --print-logs --log-level DEBUG debug config later completed the same bootstrap in 216 ms. After the generated dependency files existed, a normal non-pure run completed in 254 ms.

This appears to be the per-directory Npm.install() for @opencode-ai/plugin blocking Plugin.init() through Config.waitForDependencies() whenever local plugins exist. The first launch provides no progress or timeout while waiting.

Expected behavior: the TUI should render promptly, or show dependency-install progress and fail within a bounded time.

Related issues:

• Instance bootstrap can hang indefinitely — plugin.init() npm install has no timeout and the per-directory boot promise is cached #33905 describes the same unbounded Config.waitForDependencies() mechanism, but was closed as a duplicate of an unrelated no-plugin rendering issue.
• Plugin import hangs silently when resolving npm specifiers (e.g. oh-my-openagent@latest) #31463 covers cold-cache Arborist hangs while installing npm-specifier plugins into the global cache. This report concerns the generated project .opencode install.
• .opencode/node_modules/ causes startup hang — scanner doesn't skip node_modules despite .gitignore #30337 covers generated .opencode/node_modules, but attributes the delay to scanning an existing dependency tree.
• 1.18.21: plugin installer times out fetching public deps from registry.npmjs.org (NpmInstallFailedError: FetchError) — silent dead plugin / boot hang; headless run/serve hangs with any plugin #44684 reports related plugin installation and boot hangs in 1.18.21.

Plugins

Four local file plugins under ~/.config/opencode/plugins: herdr-agent-state.js, herdr-worktree-identity.ts, test-oracle-guard.ts, and zsh-reserved-name-guard.ts.

OpenCode version

1.18.20

Steps to reproduce

1. Configure at least one local file plugin under ~/.config/opencode/plugins.
2. Open a fresh checkout or git worktree containing .opencode/skills, with no generated .opencode/package.json, package-lock.json, or node_modules yet.
3. Run opencode in that worktree.
4. Observe the blank TUI while the per-directory dependencies are installed.
5. Start OpenCode again after the dependency files exist; startup is fast.

Screenshot and/or share link

The affected pane was entirely blank, and no share session was created.

Operating System

macOS 14.7.4

Terminal

Herdr 0.8.2

[github-actions]

This issue might be a duplicate of existing open issues. Please check:

• V2 plugin npm install can hang the session startup with no timeout #41934: V2 plugin npm install can hang the session startup with no timeout
• Plugin init and config hook can block the opencode layer indefinitely #46161: Plugin init and config hook can block the opencode layer indefinitely
• Instance service init has no timeout and can hang the bootstrap layer indefinitely #46166: Instance service init has no timeout and can hang the bootstrap layer indefinitely

These cover the same unbounded Npm.install() / bootstrap hang you've described. If your report adds new context (the per-directory .opencode install path specifically, as distinct from the global cache path in #31463), it may still be worth keeping open — but please check those issues first and comment there if they already capture the problem.