"shell_client" tool is unavailable after latest update #56794

Activity

1. opencode-agent commented on Oct 18, 2026

   

   opencode-agentBot

   on Oct 18, 2026 – with OpenCode Agent

   Contributor

   More actions

   Thanks for the report, @sayberwar.

   I think this is a duplicate of #56193. OpenCode doesn't register a tool called shell_client; its only shell tool is shell. So the No tool named "shell_client" error means OpenCode is rejecting a name it never offered to the model.

   In #56193 the reporter traced the cause to a relay between OpenCode and the model, 9Router. On Windows clients, 9Router renames OpenCode's shell tool to shell_client and tells the model that shell is a placeholder it shouldn't call. The fix is tracked upstream in decolua/9router#4971 (fix in decolua/9router#4972). Until that ships, these workarounds should help:

   • a small plugin that registers shell_client and forwards calls to shell, or
   • an AGENTS.md note telling the model to always call shell.

   Possible duplicates and related issues, ordered by likelihood:

   • tools: built-in shell tool advertised to the model as "shell_client", but runtime only executes "shell" #56193: same shell_client error on Windows 11, caused by the 9Router relay renaming shell
   • Plugin tools in catalog cannot be invoked directly: "No tool named …" #50312: tools listed to the model that can't be called, failing with No tool named … (plugin and Code Mode tools, so probably a different problem)

   If you're not using 9Router or another OpenAI-compatible relay or proxy, please reply with your provider and model, including the npm package and baseURL from your config, with API keys removed. Otherwise the bot will close this issue as a duplicate in 1 day.
2. opencode-agent

   added

   pending close

   triaging

   on Oct 18, 2026
3. opencode-agent

   closed this as duplicateon Oct 19, 2026
4. opencode-agent commented on Oct 19, 2026

   

   opencode-agentBot

   on Oct 19, 2026 – with OpenCode Agent

   Contributor

   More actions

   We haven't heard back, so I'm closing this as a duplicate of #56193. That issue has the same No tool named "shell_client" error on Windows 11. Its cause was the 9Router relay renaming OpenCode's shell tool to shell_client, and the fix is tracked upstream in decolua/9router#4971.

   If you aren't using 9Router or another relay or proxy, please comment with your provider, model, npm package and baseURL (no API keys), and we'll take another look.