android-source-search
starsforks
How to install android-source-search?
rcosteira79/android-skills/android-source-search
$npx -y skills add rcosteira79/android-skills --skill android-source-searchUse when needing to fetch Android source code — AOSP platform internals (@hide APIs, framework classes, system services) or AndroidX/Jetpack library source and samples. Also use when public docs are insufficient to complete a task and implementation details must be read directly
SKILL.md
| 1 | # Android Source Search |
| 2 | |
| 3 | Two source trees, two access strategies. AOSP lives on `android.googlesource.com` (Gitiles); AndroidX lives on GitHub. **`cs.android.com` blocks automated fetching — it's a human-browse JS SPA only** (never WebFetch it). |
| 4 | |
| 5 | ## Preferred: the android-sources MCP |
| 6 | |
| 7 | If `mcp__android-sources__*` tools are available, **always prefer them** over WebFetch/gh — local source, sub-10ms lookups: |
| 8 | |
| 9 | | Goal | MCP tool | |
| 10 | |------|----------| |
| 11 | | Find a class by name/pattern | `search_classes` (glob, e.g. `*ViewModel*`) | |
| 12 | | Read full class / a method / its members | `lookup_class` / `lookup_method` / `list_class_members` | |
| 13 | | Class hierarchy | `get_class_hierarchy` | |
| 14 | | Search text/regex across sources | `search_in_source` | |
| 15 | | List AndroidX artifact versions | `list_available_versions` | |
| 16 | | Definition / references / type info (LSP) | `goto_definition` / `find_references` / `get_type_info` | |
| 17 | |
| 18 | Fall back to the WebFetch/gh strategies below only when the MCP tools aren't available. |
| 19 | |
| 20 | ## Fallback: WebFetch + gh |
| 21 | |
| 22 | **AOSP** (framework internals, `@hide` APIs, internal constants, default attr values) **→ Gitiles.** Raw text is base64-encoded and smaller: |
| 23 | |
| 24 | ``` |
| 25 | https://android.googlesource.com/platform/frameworks/base/+/refs/heads/main/{path}?format=TEXT |
| 26 | ``` |
| 27 | |
| 28 | Use `refs/heads/main` (the active default branch), or a tag like `android-14.0.0_r74` for a specific API level. Key repos: `platform/frameworks/base` (`core/java/android/` → View/Activity/Context; `services/core/java/` → system services; `core/res/` → default attrs/styles), `platform/libcore` (`ojluni/src/main/java/` → Java core). |
| 29 | |
| 30 | **AndroidX** (`androidx.*` source + samples) **→ GitHub.** File content via `raw.githubusercontent.com`; directory listings via `gh api`: |
| 31 | |
| 32 | ``` |
| 33 | https://raw.githubusercontent.com/androidx/androidx/androidx-main/{path} |
| 34 | gh api repos/androidx/androidx/contents/{path} --jq '.[].name' |
| 35 | ``` |
| 36 | |
| 37 | Samples live next to the source as `{ClassName}Samples.kt` under a `samples/` subpath. Key path prefixes: Compose UI `compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/`, Foundation `compose/foundation/foundation/src/commonMain/kotlin/`, Animation `compose/animation/animation/src/commonMain/kotlin/`. AndroidX *is* mirrored on Gitiles (`platform/frameworks/support`, `androidx-main`), but the GitHub layout is the canonical, better-documented path for `androidx.*` — prefer it. |
| 38 | |
| 39 | ## When the path is unknown |
| 40 | |
| 41 | Use `cs.android.com` as a **human search UI** (not WebFetch — JS SPA) to locate the class/file, then fetch via Gitiles (AOSP) or `raw.githubusercontent.com` / `gh api` (AndroidX): |
| 42 | |
| 43 | ``` |
| 44 | https://cs.android.com/search?q=ClassName+methodName&ss=android # &ss=androidx for AndroidX |
| 45 | ``` |
| 46 | |
| 47 | Both trees change frequently — always fetch current source rather than trusting remembered line numbers. |
People who liked this also viewed
6 picksType
- hyperframes-cliUse the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, SkillsJul 2026
- request-refactor-planSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- analyze-projectRigor Analyze / Rigor Audit read-only skill for deep learning research repositories. Use when the user wants to read and understand a repository, inspect model structure and training or inference entrSkillsMay 2026
- explore-codeRigor Improve implementation leaf skill for auditable candidate implementation in deep learning research repositories. Use when the researcher explicitly authorizes exploratory work on an isolated braSkillsMay 2026
- ubiquitous-languageSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- scaffold-exercisesSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
