# Android Source Search

> Use 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 from source.

- Skill: `rcosteira79/android-source-search` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rcosteira79/android-source-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rcosteira79/android-source-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: rcosteira79 (https://skillmd.com/u/rcosteira79)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rcosteira79/android-source-search

---


# Android Source Search

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).

## Preferred: the android-sources MCP

If `mcp__android-sources__*` tools are available, **always prefer them** over WebFetch/gh — local source, sub-10ms lookups:

| Goal | MCP tool |
|------|----------|
| Find a class by name/pattern | `search_classes` (glob, e.g. `*ViewModel*`) |
| Read full class / a method / its members | `lookup_class` / `lookup_method` / `list_class_members` |
| Class hierarchy | `get_class_hierarchy` |
| Search text/regex across sources | `search_in_source` |
| List AndroidX artifact versions | `list_available_versions` |
| Definition / references / type info (LSP) | `goto_definition` / `find_references` / `get_type_info` |

Fall back to the WebFetch/gh strategies below only when the MCP tools aren't available.

## Fallback: WebFetch + gh

**AOSP** (framework internals, `@hide` APIs, internal constants, default attr values) **→ Gitiles.** Raw text is base64-encoded and smaller:

```
https://android.googlesource.com/platform/frameworks/base/+/refs/heads/main/{path}?format=TEXT
```

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).

**AndroidX** (`androidx.*` source + samples) **→ GitHub.** File content via `raw.githubusercontent.com`; directory listings via `gh api`:

```
https://raw.githubusercontent.com/androidx/androidx/androidx-main/{path}
gh api repos/androidx/androidx/contents/{path} --jq '.[].name'
```

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.

## When the path is unknown

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

```
https://cs.android.com/search?q=ClassName+methodName&ss=android    # &ss=androidx for AndroidX
```

Both trees change frequently — always fetch current source rather than trusting remembered line numbers.