Skip to content

SUPPORT.md

Latest commit

 

History

History
36 lines (24 loc) · 1.65 KB

SUPPORT.md

File metadata and controls

36 lines (24 loc) · 1.65 KB

Support

Getting Help

Documentation

  • README — Setup, configuration, environment variables, FAQ
  • Developer Guide — Architecture, data flows, testing, internals

Community

  • GitHub Discussions — Ask questions, share ideas, get help from the community
  • GitHub Issues — Report bugs or request features (use the templates provided)

Troubleshooting

Before opening an issue, try these steps:

  1. Check the FAQ in the README
  2. Enable debug logging — set SOCRATICODE_LOG_LEVEL=debug and/or SOCRATICODE_LOG_FILE=/tmp/socraticode.log in your MCP config
  3. Check Docker — run docker ps to verify containers are running
  4. Check health — ask your AI to run codebase_health for a full infrastructure status report
  5. Search existing issues — your question may already have an answer

Common Issues

Problem Solution
"Docker is not available" Install and start Docker Desktop
Slow indexing on macOS/Windows Install native Ollama for GPU acceleration, or use OpenAI embeddings
Search returns no results Ensure the project is indexed (codebase_status)
MCP host disconnects during indexing Poll codebase_status every ~60s to keep the connection alive; indexing resumes automatically

Commercial Support

For commercial licensing or enterprise support, contact giancarlo@altaire.com.