swiftfindrefs
Use swiftfindrefs (IndexStoreDB) to list every Swift source.
Setup & Installation
Install command
clawhub install michaelversus/swiftfindrefsIf the CLI is not installed:
Install command
npx clawhub@latest install michaelversus/swiftfindrefsOr install with OpenClaw CLI:
Install command
openclaw skills install michaelversus/swiftfindrefsor paste the repo link into your assistant's chat
Install command
https://github.com/openclaw/skills/tree/main/skills/michaelversus/swiftfindrefsWhat This Skill Does
swiftfindrefs queries Xcode's IndexStore (DerivedData) to return every Swift source file that references a given symbol. It covers classes, structs, enums, protocols, functions, and variables across modules. Output is one absolute file path per line, deduplicated and safe to pipe.
grep and IDE search operate on text and miss references that the compiler resolved through type inference or module re-exports, while IndexStoreDB reflects what was actually compiled.
When to Use It
- Finding all callers of a function before renaming it
- Auditing files affected by moving a type to a new module
- Adding missing imports only to files that reference a relocated symbol
- Confirming a symbol is unused before deleting it
- Scoping a cross-module refactor to exactly the files that matter
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Finding all callers of a function before renaming it
- 1Finding all callers of a function before renaming it
- 2Auditing files affected by moving a type to a new module
- 3Adding missing imports only to files that reference a relocated symbol
- 4Confirming a symbol is unused before deleting it
- 5Scoping a cross-module refactor to exactly the files that matter
Use swiftfindrefs (IndexStoreDB) to list every Swift source.
Security Audits
These signals reflect official OpenClaw status values. A Suspicious status means the skill should be used with extra caution.