Project Structure Index

gwt maintains a vector search index of all project files using ChromaDB embeddings.

File search command

Run in terminal to find files related to a feature or concept:

~/.gwt/runtime/chroma-venv/bin/python3 ~/.gwt/runtime/chroma_index_runner.py \
  --action search \
  --db-path "$GWT_PROJECT_ROOT/.gwt/index" \
  --query "your search query" \
  --n-results 10

On Windows, use ~/.gwt/runtime/chroma-venv/Scripts/python.exe as the Python executable.

File search output format

JSON object with ranked results:

{"ok": true, "results": [
  {"path": "src/git/issue.rs", "description": "GitHub Issue commands", "distance": 0.12},
  {"path": "src/lib/components/IssuePanel.svelte", "description": "Issue list panel", "distance": 0.25}
]}

When to use

• Task start: search for files related to the assigned feature
• Bug investigation: find files that might relate to the bug
• Feature addition: locate existing similar implementations
• Architecture understanding: discover how components are organized

Environment

• GWT_PROJECT_ROOT: absolute path to the project root (set by gwt at pane launch)

Notes

• File index is auto-generated when the project is opened in gwt
• Uses semantic similarity (not just keyword matching)
• Lower distance values indicate higher relevance
• For Issue search, use gwt-issue-search instead