Troubleshooting › Fix: /ptt Command Not Working

Fix: /ptt Command Not Working

Symptom: Typing /ptt in OpenCode does nothing, shows "unknown command" error, or fails silently.

Common Causes

⚠ Plugin not loaded

→ Run opencode plugin list. If interrupt is not listed, add "opencode-interrupt-plugin" to opencode.json and restart.

⚠ Plugin config hook failed

→ The plugin registers /ptt via the config hook. Check logs at ~/.local/share/opencode/log/ for errors during plugin initialization.

⚠ Old plugin cache

→ Delete the cache: rm -rf ~/.cache/opencode/packages/opencode-interrupt-plugin@latest. Then restart OpenCode.

⚠ Command conflict

→ Another plugin may have registered a "/ptt" command. Check all plugins in opencode.json for duplicate command registrations.

⚠ Session not active

→ Open a session first, then type /ptt. The command requires an active session context.

Fallback

If /ptt still fails after troubleshooting, remove and re-add the plugin: delete the cache, remove from opencode.json, restart, add back, restart again.

Still having trouble?

Contact support →