TroubleshootingFix: /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 →