Troubleshooting

Splat command not found

This usually means Splat is not installed or not in your PATH.Solution:

Verify installation:
```
pip show splat
```
If not installed, install Splat:
```
pip install -e .
```
Ensure your Python scripts directory is in PATH:
```
export PATH="$HOME/.local/bin:$PATH"
```

Code formatting issues after fixes

Splat currently does not conform to formatting configurations when inserting code.Solution:After Splat fixes your code, run your formatter manually:

black your_file.py

Or if using other formatters:

# Prettier for JavaScript/TypeScript
prettier --write your_file.js

# autopep8 for Python
autopep8 --in-place your_file.py

Sub-module entrypoint errors

Splat may not work correctly with entrypoints that don’t originate in the root directory.Solution:

Run Splat from your project root directory:

cd /path/to/project/root
splat squash "python3 submodule/main.py"

Or create a wrapper script in the root that calls your sub-module:

# run.py
from submodule import main
main.run()

Then use:

splat squash "python3 run.py"

Missing API key or Groq errors

Splat uses Groq for AI inference and requires an API key.Solution:

If missing, create a .env file:

echo "GROQ_API_KEY=your_api_key_here" > .env

Git-aware features not working

If Splat is not respecting your .gitignore file:Solution:

Installation dependency errors

Missing dependencies can cause various errors.Solution:Install all required dependencies:

pip install -r requirements.txt

Or install individually:

pip install click repopack setuptools virtualenv groq fastapi uvicorn python-dotenv prompt_toolkit requests black pydantic_ai pydantic zmq

Command not executing properly

If your command runs but Splat doesn’t capture errors:Solution:

Ensure you’re wrapping the command in quotes:
```
splat squash "python3 main.py"
```
Try the -r flag for more context:
```
splat squash -r "python3 main.py"
```
Check that the command fails when run normally (Splat needs errors to debug)

Common Issues