Troubleshooting

Installation and Setup Issues

"claude: command not found"

"bd: command not found"

MCP server shows disconnected in /mcp

Authentication fails

Plugins not appearing in /plugin list

Build Issues

Claude keeps making the same mistake over and over

Claude forgets what was built earlier in the session

Claude wrote code that breaks existing tests

Build hangs or Claude stops responding

Claude suggests libraries or APIs that don't exist

Git Issues

Accidentally committed to main

Merge conflict between branches

Need to undo all changes from a phase

Context Issues

Auto-compaction happened at a bad time

is not loading

Claude in Chrome Issues

Extension not connecting

Beads is unavailable, broken, or returning errors

When to Abandon the Session" Heuristic

When to Start Fresh Instead of Debugging

Getting more help