Repository navigation
OpenCode hangs without responding to a simple prompt when AGENTS.md is present #59556
Description
Description
Description
OpenCode hangs indefinitely and produces no response, even when given a simple prompt such as halo.
This happens when OpenCode is launched from /home/xxxx with my original AGENTS.md file. The issue occurs in both Plan and Build modes.
OpenCode works normally from /home/xxxx/test. Renaming the original /home/xxxx/AGENTS.md to disable it restores normal responses. Replacing it with a simplified version also resolves the issue.
The original AGENTS.md contains general workflow instructions, including language preferences, tool creation rules, Git restrictions, and a requirement to archive and update result.md after each completed task.
I have not isolated the exact instruction responsible.
Environment
- OS: Lubuntu Linux
- OpenCode version: 1.19.4
- API provider: The provider configured in OpenCode
Steps to Reproduce
- Place the original
AGENTS.mdin/home/xxxx. - Launch OpenCode from
/home/xxxx. - Enter either Plan or Build mode.
- Send the simple prompt
halo. - Observe that OpenCode remains in a loading state without responding.
- Rename or disable the original
AGENTS.mdand repeat the test. - Observe that OpenCode responds normally.
Expected Behavior
OpenCode should respond to a simple prompt or display a meaningful error instead of hanging indefinitely.
Actual Behavior
OpenCode remains in a loading state without returning a response when the original AGENTS.md is present.
Additional Notes
The issue appears related to the original AGENTS.md, but the exact cause has not been identified. Replacing it with a simplified version resolves the issue.
Plugins
No response
OpenCode version
1.19.4
Steps to reproduce
No response
Screenshot
No response
Operating System
Lubuntu
Terminal
QTerminal
Activity
opencode-agent commentedon Oct 27, 2026
Thanks for the detailed report, @bl4ckswat!
You're on OpenCode 1.19.4, which is v1 (the
opencode-aipackage). v1 now only gets fixes for critical bugs such as data loss, security problems or breakage with no workaround. Since a simplifiedAGENTS.mdworks for you, this one is unlikely to be fixed in v1.Please try OpenCode v2 (the
@opencode/clipackage,opencodecommand), where active development happens. If the sameAGENTS.mdalso hangs on v2, reply here with your v2 version (opencode --version), your provider and model, and if you can, a trimmed copy of theAGENTS.mdthat still causes the hang. Please also reply if you think this is critical.