# Gwt Project Index

> Semantic search over project source files using vector embeddings. Use to find files related to a feature, bug, or concept.

- Skill: `akiojin/gwt-project-index` (Agent Skill)
- Install (CLI): `npx skillmds@latest add akiojin/gwt-project-index`
- Raw SKILL.md: https://api.skillmd.com/api/skills/akiojin/gwt-project-index/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: akiojin (https://skillmd.com/u/akiojin)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/akiojin/gwt-project-index

---


# 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:

```bash
~/.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:

```json
{"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