Skip to content
Arxo Arxo

Troubleshooting

Troubleshooting

Section titled “Troubleshooting”

This guide covers common issues when using Arxo. Use the sections below to find solutions.

Guides

Section titled “Guides”
GuideTopics
InstallationInstalling the Arxo CLI
AnalysisNo files found, slow runs, memory, parsing errors
Policy & ConfigPolicy violations, invalid or missing config
Metrics & OutputUnknown metric, zero results, JSON/HTML output
CachingStale results, cache size
Language-specificTypeScript, Python
DebuggingTiming, logs, reporting issues

Common Error Messages

Section titled “Common Error Messages”
ErrorMeaningSolution
Failed to parseSyntax errorFix source file syntax
Config validation failedInvalid YAMLRun arxo config validate
Metric not foundWrong metric IDRun arxo metrics list
No files analyzedWrong path/excludesCheck path and exclusions
Policy violationThreshold exceededAdjust policy or fix code
Out of memoryGraph too largeLimit nodes or exclude files

Quick diagnostics

Section titled “Quick diagnostics”
Terminal window
arxo doctor
arxo config validate --config .arxo.yaml
arxo --version

Next Steps

Section titled “Next Steps”