velalisted

Compiler-exact code search over a SCIP index - find where a symbol is defined, every reference to it, who calls it, and what a change would break. Indexes .NET itself: C#, VB, Razor Pages, MVC views and Blazor components, with every Razor reference resolved by the compiler into a saved index, where grep sees only text. Any other language - TypeScript, Python, Go, Java - reaches the same database by importing the .scip file its own indexer produces, and then the same verbs answer over it; vela does not run those indexers itself. Deterministic, built on Roslyn, never modifies the repository. Use instead of grep when searching for an ordinary identifier (Name, Status, Value, Id, Update), when you need callers or change impact, when a symbol might be used from a .cshtml or .razor file, or when grep returns too many hits to read. Trigger on phrases like "vela", "find references", "who calls", "where is this used", "change impact", "blast radius", "find usages".
dbhq-uk/vela-skill · ★ 6 · Web & Frontend · score 73

Install: claude install-skill dbhq-uk/vela-skill

# vela Compiler-exact code search over a SCIP index. .NET answers come from Roslyn, other languages from their own indexers' `.scip` files. It never writes to the repository. ## Which tool - **grep** when the name is distinctive. It is free and needs no index. - **The LSP tool**, where your host has one, for code you have just edited. It stays live, where vela needs a re-index, which takes minutes on a large solution. - **vela** for: - ordinary names (`Name`, `Status`, `Id`), where grep is mostly noise and vela reports when a name is ambiguous - references from `.cshtml` and `.razor` files - callers, implementations, and what a change touches - a survey of a clean tree before a change - **Not vela** in a repository with no .NET and no `.scip` to import. ## Steps ### 0. Check the command is installed ```bash command -v vela ``` Plugin and skills.sh installs copy this file, not the command. If it prints nothing, tell the user rather than quietly falling back to grep. vela needs: - the .NET SDK 10.0 or newer - the tool itself: clone `https://github.com/dbhq-uk/vela-skill` and run `./install.sh` - `~/.dotnet/tools` on `PATH` ### 1. Build the index vela does not restore packages. Run `dotnet restore` first if the solution has never been built. ```bash vela index ``` vela uses the solution `vela.json` names, or else the only `.sln` or `.slnx` here or in the nearest directory above, up to the repository root. If it cannot pick one, pass `--solution <path>` to eve