Troubleshooting · Foundry docs

TroubleshootingTroubleshooting

Information

Stuck on a problem? Production-Grade gives you an engineer to ask, with a response time you can plan around.

Agent keeps asking questions and haltingFoundry halts when the agent asks a question or proposes alternatives instead of executing. Fix: Make task instructions very specific. Clarify via the operator interface and resume.State is not persistingCheck that DragonflyDB is running: docker ps, redis-cli -h localhost -p 6499 ping. Foundry will fail fast if it cannot reach the persistence layer.Token costs are too high

Enable deterministic validation so many tasks pass without AI.

Use a local helper model (Ollama) for verification.

Inspect prompts.log.jsonl for oversized task descriptions or context.

Redis connection refusedEnsure --redis-host and --redis-port match your DragonflyDB. Default port is 6499. If using Docker, use localhost from the host.Task stuck or queue not advancingRun status to see supervisor and queue state. Check for blocked tasks or halt reason. Use investigation scripts (provider health, queue inspector) if available in the repo.Cursor CLI Not FoundSet the path: export CURSOR_CLI_PATH=/path/to/cursor