Custom slash commands not available until ~1 minute after startup
Description
Custom slash commands are not visible in the command list immediately after startup. They appear after approximately 1 minute delay, seemingly after background loading completes.
I have no commands in ~/.config/opencode/command/ - only a command defined in the JSON config (~/.config/opencode/opencode.json).
I was able to replicate this issue with both:
- Commands defined as markdown files in
~/.config/opencode/command/ - Commands defined in the JSON config under the
commandkey
Plugins
No response
OpenCode version
1.0.220
Steps to reproduce
- Have a custom command configured (either as markdown file or in JSON config)
- Close OpenCode completely
- Open OpenCode fresh
- Immediately type
/to see available commands - Notice custom commands are missing from the list (only built-in commands shown)
- Wait ~1 minute
- Type
/again - custom commands now appear
Screenshot and/or share link
No response
Operating System
macOS
Terminal
iTerm2
This issue might be a duplicate of existing issues. Please check:
- #3537: Custom slash commands can crash opencode on startup - Related to custom command loading issues
- #7979: Very Slow OpenCode Loading Time - General performance issue with startup delays (especially on Windows)
- #7693: Adding a trailing comma to agents markdown freezes startup - Related startup freezing with configuration files
Feel free to ignore if none of these address your specific case.
I also had this problem. In my case, I tested my MCPs one by one and found that context7 was the problem. I think opencode waits to load all the MCPs first before loading the commands.