Aspect Code logoAspect Code

Troubleshooting

Common issues and how to resolve them.

AGENTS.md didn't generate

If AGENTS.md isn't being generated:


Check supported languages:

Aspect Code analyzes Python, TypeScript, JavaScript, Java, and C#. If your project only contains other languages, there won't be enough data to generate useful instructions.


Check the terminal output:

Look for error messages in the terminal where you ran aspectcode.


Try verbose mode:

aspectcode --verbose

This shows detailed analysis progress and any issues encountered.

Slow on large projects

For very large codebases (thousands of files), initial analysis may take a few minutes.


Tips:

  • Subsequent runs with watch mode are incremental and much faster
  • You can scope analysis to a subdirectory by running aspectcode from that directory
  • Use --once for one-time analysis if you don't need continuous updates

    • How to fully remove Aspect Code

    1. Stop the CLI:

    Press Ctrl+C in the terminal, or close the terminal.


    2. Uninstall (if installed globally):

    npm uninstall -g aspectcode

    3. Remove generated files:

    rm -f AGENTS.md
rm -rf .aspect/

    4. Uninstall VS Code extension (if installed):

    Open Extensions → Find "Aspect Code" → Click Uninstall

    Reporting bugs

    Open an issue at github.com/asashepard/aspectcode/issues.


    Include:

  • What you expected to happen
  • What actually happened
  • Steps to reproduce
  • Terminal output (without sensitive data)
  • Aspect Code version (aspectcode --version)

    • Or email asa@aspectcode.com for direct support.

    Supported Languages