Skip to content

docs(readme): add troubleshooting entry for stale plugin cache auth failure #134

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
JiwaniZakir wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(readme): add troubleshooting entry for stale plugin cache auth failure #134

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,7 @@ If only one account is found, the switcher is hidden and the plugin uses it dire
| "Credentials not found" | Run `claude` to authenticate with Claude Code first |
| "Keychain is locked" | Run `security unlock-keychain ~/Library/Keychains/login.keychain-db` |
| "Token expired and refresh failed" | The plugin runs `claude` CLI to refresh automatically. If this fails, re-authenticate manually by running `claude` |
| Plugin added to `opencode.json` but auth still fails | Run `rm -rf ~/.cache/opencode` then restart OpenCode — it will reinstall plugins fresh from the cache |

@greptile-apps greptile-apps Bot Jul 25, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 The explanation at the end of the solution is contradictory — after running rm -rf ~/.cache/opencode the cache no longer exists, so describing the subsequent reinstall as happening "from the cache" is misleading. OpenCode would be fetching/reinstalling the plugins from their original source, not from a (now-deleted) cache.

Suggested change
| Plugin added to `opencode.json` but auth still fails | Run `rm -rf ~/.cache/opencode` then restart OpenCode — it will reinstall plugins fresh from the cache |
| Plugin added to `opencode.json` but auth still fails | Run `rm -rf ~/.cache/opencode` then restart OpenCode — it will reinstall plugins fresh on next startup |
Prompt To Fix With AI 
This is a comment left during a code review.
Path: README.md
Line: 106

Comment:
The explanation at the end of the solution is contradictory — after running `rm -rf ~/.cache/opencode` the cache no longer exists, so describing the subsequent reinstall as happening "from the cache" is misleading. OpenCode would be fetching/reinstalling the plugins from their original source, not from a (now-deleted) cache.

```suggestion
| Plugin added to `opencode.json` but auth still fails | Run `rm -rf ~/.cache/opencode` then restart OpenCode — it will reinstall plugins fresh on next startup             |
```

How can I resolve this? If you propose a fix, please make it concise.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Fix in Cursor Fix in Claude Code Fix in Codex

| Not working on Linux/Windows | Ensure `~/.claude/.credentials.json` exists. Run `claude` to create it |
| Keychain access denied | Grant access when macOS prompts you |
| Keychain read timed out | Restart Keychain Access (can happen on macOS Tahoe) |
Expand Down
Loading