Skip to content

Commit 38686e3

Browse files
committed
Improve troubleshooting
1 parent 91e9d5d commit 38686e3

File tree

1 file changed

+8
-25
lines changed

1 file changed

+8
-25
lines changed

web/src/content/advanced/troubleshooting.mdx

Lines changed: 8 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,14 @@ order: 1
99

1010
[Open an issue](https://github.com/CodebuffAI/codebuff/issues) or check existing reports.
1111

12+
## Install Node
13+
14+
If you don't have `npm`, [get Node here](https://nodejs.org/en/download).
15+
16+
## Delete local cache
17+
18+
Codebuff stores files at `~/.config/manicode` including the binary `codebuff`. Sometimes deleting the binary and restarting codebuff will fix issues.
19+
1220
## Version
1321

1422
The latest version of the Codebuff client can be found on the [npm page](https://www.npmjs.com/package/codebuff).
@@ -17,10 +25,6 @@ Run `codebuff --version` to make sure you're on the latest version.
1725

1826
Codebuff should auto-update. If not, try the steps below.
1927

20-
## Codebuff not updating
21-
22-
If you see the npm install run but Codebuff still isn't at the latest version, this is most likely an issue with npm's cache. Try running `npm cache clean --force` and then `npm install -g codebuff`.
23-
2428
## Install failed
2529

2630
If `npm install -g codebuff` gave you an error regarding permissions, try using setting the owner of that directory to your user.
@@ -39,27 +43,6 @@ Include recent chats if you ask for help.
3943

4044
## Common Issues
4145

42-
### Connection Issues
43-
44-
If you see a message like this:
45-
46-
```bash
47-
/Users/<youruser>/Library/pnpm/global/5/.pnpm/codebuff@someversion/node_modules/codebuff/dist/common/websockets/websocket-client.js:158
48-
reject(new Error(`Websocket message with txid ${txid} timed out.`)); ^
49-
50-
Error: Websocket message with txid 32 timed out.
51-
at Timeout._onTimeout (/Users/<youruser>/Library/pnpm/global/5/.pnpm/codebuff@someversion/node_modules/codebuff/dist/common/websockets/websocket-client.js:158:28)
52-
at listOnTimeout (node:internal/timers:594:17)
53-
at process.processTimers (node:internal/timers:529:7)
54-
55-
Node.js v22.12.0
56-
```
57-
58-
it means you're having connection issues. In that case, try:
59-
60-
1. Check your internet connection.
61-
2. Try logging out and back in with `logout` followed by `login`.
62-
6346
### Endless Auto-Updates
6447

6548
If Codebuff keeps trying to update itself in a loop, check the items below:

0 commit comments

Comments
 (0)