-
Notifications
You must be signed in to change notification settings - Fork 0
Troubleshooting
settletop-niles edited this page Nov 26, 2025
·
5 revisions
Common checks and fixes for CodeRoot.ai:
- I don't see
.coderootin VS Code: use "CodeRoot: Toggle .coderoot Visibility" - Reports look sparse: work in the repo after initializing; the report summarizes local activity
- Git not detected: enable the VS Code Git extension and ensure Git is on PATH
If you need help, open an issue using the templates.
Top issues (symptom → quick fix)
-
Symptom: Report generation looks incomplete
Fix: Ensure you've run "CodeRoot: Initialize CodeRoot" and made changes in the workspace; then run "CodeRoot: Generate Report".
-
Symptom: Identity totals don't match expectations
Fix: Run "CodeRoot: Consolidate Identities Now", then regenerate the report.
-
Symptom: Nothing appears under
.coderoot/Fix: The folder may be hidden; toggle visibility from the Quick Menu.
When to file an issue
- Deterministic mismatches between report totals and expectations
- Crashes with an error you can't interpret
- Questions about interpreting Human vs AI vs Untracked