Skip to content

TROUBLESHOOTING.md

Latest commit

 

History

History
52 lines (37 loc) · 1.91 KB

TROUBLESHOOTING.md

File metadata and controls

52 lines (37 loc) · 1.91 KB
Raw

Troubleshooting

Install paths: QUICK_START.md.

Install

Problem Fix
grinta not found From the Grinta source checkout, run pipx install -e .; see QUICK_START.md
grinta not found in WSL Install inside Ubuntu, not Windows
uv not found .\START_HERE.ps1 or bash start_here.sh
Python 3.12+ uv python install 3.12 or re-run the start script

Startup

  • No TUI: stdin is not a TTY (piped/redirected) — use interactive terminal or grinta --help
  • Bad config: grinta init or fix settings.json — see SETTINGS.md
  • Missing key: set LLM_API_KEY in ~/.grinta/.env or repo .env

LLM

Error Fix
401 Key must match model prefix (openai/…, anthropic/…, etc.)
Model not found Use qualified ID, e.g. openai/gpt-5.1, ollama/llama3.2
Ollama down ollama serve then ollama pull <model>

Windows

  • Git Bash instead of the PowerShell default: set "security": { "windows_shell": "bash" } in settings. Native-Windows onboarding defaults to powershell; Git Bash remains supported.
  • Long paths: enable Windows long paths (registry LongPathsEnabled=1)

WSL2

  • Slow startup / agent stalls: clone on /mnt/c — move repo to Linux home; run grinta doctor
  • Wrong install: use pipx inside Ubuntu, not Windows PowerShell
  • grinta not found in WSL: install inside Ubuntu (QUICK_START.md)
  • Project on /mnt/c is slow: expected; see QUICK_START.md — WSL
  • tmux / shell errors: ensure TMUX_TMPDIR writable; run grinta doctor on WSL

Checks

grinta doctor          # full install report
grinta doctor --verbose

In TUI: /health (fast subset).

Still stuck: SUPPORT_MATRIX.md · open an issue with command, error, OS, Python version.