>_ ccboard

Troubleshooting

Common Issues

IssueSolution
Slow first startupNormal. Cache build takes ~20s, then 224ms
Data not updatingPress r to force refresh
Web port in useUse --port 8080 (or any free port)
Cache corruptionRun ccboard clear-cache
No sessions foundVerify ~/.claude/sessions/ exists and contains JSONL files

Installation Issues

Homebrew

# If tap is outdated
brew update
brew upgrade ccboard

# If install fails
brew tap --repair FlorianBruniaux/tap
brew install ccboard

Cargo

# If build fails
rustup update
cargo install ccboard --force

Permission Errors

# If ccboard can't read ~/.claude/
ls -la ~/.claude/
# Should be readable by your user

Cache Issues

If ccboard shows stale or incorrect data:

# Clear and rebuild cache
ccboard clear-cache
ccboard

The cache is stored at ~/.cache/ccboard/ and is rebuilt automatically.

Web Interface Issues

# Port already in use
ccboard web --port 8080

# Check if server is running
curl http://localhost:3333/

Getting Help