Skip to content

docs: add TROUBLESHOOTING.md - #130

Closed
TerminalGravity wants to merge 1 commit into
mainfrom
docs/troubleshooting
Closed

docs: add TROUBLESHOOTING.md#130
TerminalGravity wants to merge 1 commit into
mainfrom
docs/troubleshooting

Conversation

@TerminalGravity

Copy link
Copy Markdown
Collaborator

Adds a comprehensive troubleshooting guide covering:

  • Installation issues (native modules, Apple Silicon, tsx)
  • Embedding & indexing (LanceDB setup, Xenova model download, OpenAI config)
  • MCP connection debugging
  • Scorecard and PDF export gotchas
  • Cross-service configuration
  • Links from README nav bar

Covers installation issues (native modules, Apple Silicon, tsx),
embedding/indexing problems (LanceDB, Xenova model download, OpenAI),
MCP connection debugging, scorecard/PDF gotchas, and cross-service
config. Links from README nav bar.

@TerminalGravity TerminalGravity left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Solid troubleshooting guide covering the pain points new users would hit (native modules on Apple Silicon, LanceDB, MCP connection). Good addition to the nav bar. Ready to merge.

@TerminalGravity

Copy link
Copy Markdown
Collaborator Author

Superseded by #138.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant