Menú
Search indexed codebases using the pharos CLI — BM25/vector/hybrid search and call graph traversal
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
| name | pharos |
| description | Search indexed codebases using the pharos CLI — BM25/vector/hybrid search and call graph traversal |
| trigger | Use when asked to find, explore, or navigate code in an indexed project |
You have access to the pharos command line tool for code search and navigation.
Use it instead of grep or file reads when the current project is indexed.
pharos runs a persistent background daemon — the first call may take a few seconds to start it; all subsequent calls are fast (~200ms).
Start with pharos projects to confirm the project is indexed before using other commands.
| Goal | Command |
|---|---|
| Find code by concept or description | pharos search "<query>" |
| Find code by exact method or class name | pharos search "<name>" --type keyword |
| Single-pass BM25 + vector combined ranking | pharos search "<query>" --type unified |
| Restrict to methods or classes | pharos search "<query>" --doc-type method|class |
| Restrict to one project | pharos search "<query>" --project <name> |
| Control result count | pharos search "<query>" --limit 20 |
| Show pipeline trace (resolved type + timings) | pharos search "<query>" --trace |
| Control snippet size per result | pharos search "<query>" --snippet-lines 20 |
| Goal | Command |
|---|---|
| Get full method implementation | pharos method "<fqn>" |
| Get full class body | pharos class "<qualifiedName>" |
| Get class with fields, constructors, public methods + callers | pharos class "<qualifiedName>" --context |
| Goal | Command |
|---|---|
| Who calls a method | pharos callers "<fqn>" [--limit N] |
| What a method calls | pharos callees "<fqn>" [--limit N] |
| Multi-hop call chain with bodies | pharos trace "<fqn>" [--depth 2] [--direction callees|callers|both] [--max-body 500] |
| All transitive callers — impact analysis | pharos impact "<fqn>" [--depth 5] [--max 2000] |
| Shortest path between two methods | pharos path "<from_fqn>" "<to_fqn>" |
| Goal | Command |
|---|---|
| All usages (callers, subclasses, field access, annotations, type refs) | pharos usages "<fqn>" |
| Specific usage kind | pharos usages "<fqn>" --kind callers|subclasses|field_readers|field_writers|annotated|type_refs |
| Goal | Command |
|---|---|
| List indexed projects | pharos projects [--limit N] |
| List Maven modules | pharos modules [--filter indexed|external] [--limit N] |
| Module dependency tree | pharos deps <module> [--transitive] [--limit N] |
| Dependency path between modules | pharos mod-path <from> <to> |
| Module public API surface | pharos boundary <project> [--limit N] |
| Goal | Command |
|---|---|
| Project structure as file tree | pharos skeleton <project> [--path <dir>] [--depth N] [--limit N] |
| Index a project | pharos index <path> [--force] [--full] [--no-embed] [--single] [--depth N] [--project-threads N] |
| Daemon lifecycle | pharos daemon status|start|stop|restart|logs |
com.example.MyClass#methodName(ParamType1,ParamType2)
Use FQNs from pharos search results directly in method, class, callers, callees, trace, impact, usages.
pharos search defaults to --type auto which classifies the query and picks the best strategy:
All listing commands accept --limit N (default 0 = no limit). search defaults to --limit 10.
Use --limit 0 to remove the cap, or a positive number to cap output.
pharos index <path> # incremental re-index (only changed files)
pharos index <path> --full # re-parse all files
pharos index <path> --force # delete existing index then re-index
pharos index <path> --no-embed # skip vector embedding (faster, no semantic search)
pharos index <path> --single # treat as one project even if sub-projects exist
pharos index <path> --depth 2 # workspace discovery depth (default: 3)
pharos index <path> --project-threads 4 # index N projects in parallel
pharos skeleton <project> # full public API as filesystem tree
pharos skeleton <project> --path src/main/java/com/example # scope to a subdirectory
pharos skeleton <project> --path src/main/java/com/example --depth 1 # direct children only
pharos skeleton <project> --limit 20 # cap at 20 classes shown
pharos skeleton <project> --method-limit 200 # cap at 200 total methods fetched
"Where is X implemented?"
pharos search "X"
pharos method "com.example.MyClass#x()"
pharos callees "com.example.MyClass#x()"
"Understand a class before modifying it"
pharos class "com.example.MyService" --context
Returns: body, declared fields, constructors (shows injected deps), public methods + direct callers.
"Who uses this API / impact of changing a method?"
pharos callers "com.example.MyClass#x()" # direct callers
pharos impact "com.example.MyClass#x()" # all transitive callers, no bodies
pharos trace "com.example.MyClass#x()" --direction callers --depth 3 # callers with bodies
"Trace an execution path / understand dependencies"
pharos trace "com.example.PaymentService#process(Order)" --direction callees --depth 2
pharos path "com.example.Entry#main(String[])" "com.example.MyClass#x()"
"Find all implementations of an interface / subclasses"
pharos usages "com.example.Repository" --kind subclasses
"Find everything annotated with @Transactional"
pharos usages "Transactional" --kind annotated
"Where is this field read or written?"
pharos usages "com.example.PaymentService#connectionPool" --kind field_readers
pharos usages "com.example.PaymentService#connectionPool" --kind field_writers
"Find an exact class or method by name"
pharos search "ClassName" --type keyword --doc-type class
pharos search "methodName" --type keyword --doc-type method
"How are two modules connected?"
pharos mod-path com.example:module-a com.example:module-b
pharos boundary my-project
"What is the public API of a package?"
pharos skeleton my-project --path src/main/java/com/example/api --depth 1
"Re-index after major changes (clean slate)"
pharos index /path/to/project --force --no-embed
"Debug why search returned unexpected results"
pharos search "query" --trace
Shows resolved type (what auto chose), stage timings, and pipeline used.
Run pharos <command> --help for full options on any command.