name	ksrc
description	Search/read 3rd-party Gradle dependency sources. Avoid directly accessing `.gradle`; instead, proactively use this skill to inspect source code of dependencies to learn API shapes or implementations.

Search dependencies to retrieve coordinates and matches using rg-style globs: ksrc search "class LocalDate\("

If you want faster execution & less noise, consider adding:

--artifact to limit search to one artifact, (or --module to also limit by version)
--subproject to help discovery for monorepos/large modular apps
--targets to limit to specific KMP targets.

KMP note: --module group:artifact searches common/base sources plus Gradle-selected platform variant source jars by default. Use --targets or --config to narrow variants.

Read a file by returned id: ksrc cat org.jetbrains.kotlinx:kotlinx-datetime:0.8.0!/kotlinx/datetime/LocalDate.kt --lines 1,200

File-id format: group:artifact:version!/path/inside/jar.ext — works for any language in the source JAR (e.g. .kt, .java, .groovy)

When a file-id comes from ksrc search or ksrc where <path>, follow-up cat/open usually do not need repeated --project or scope/config flags on same machine.

Give this tool generous timeouts. It can take a few minutes to download sources and set up gradle.

Common issues

If, unexpectedly, no matches are found, try --project with app project (not monorepo root), specifying --scope (esp. for build-time deps), or ksrc doctor.
E_NO_SOURCES: dependency sources not available; try ksrc deps, ksrc fetch <coord>, specify a project and scope.
Gradle not found: a) run in a Gradle project dir, b) set --project path explicitly, c) install gradle on machine.
Gradle build script is failing in the repo: ksrc falls back to cache-only resolution and warns; when no version is pinned it picks the highest cached source-bearing version under Maven-style ordering. Re-run with -v to see Gradle output for debugging.
Custom Gradle user home: ksrc respects GRADLE_USER_HOME. Use --gradle-user-home <path> to override it for both Gradle invocation and cache fallback.
Gradle fails with unresolved class version: User's Local java in env is resolved to something unsupported by gradle. Help them fix Gradle<>JDK incompatibility.
Ambiguous modules: use --module, --group, or --artifact to narrow scope.

Commands

`ksrc search <pattern> [-- <rg-args>]`

Search dependency sources.

Output format: <file-id> <line>:<col>:<line-text>

Parsing rule:

Split once on first space to isolate <file-id>.
Parse first two :-delimited decimal fields as <line> and <col>.
Treat remainder verbatim as <line-text>; it may contain :.

With --show-extracted-path, output shape changes to: <file-id>\t<quoted-extracted-path>\t<line>\t<col>\t<quoted-line-text>

Common flags:

--all search across all resolved deps (default, slow)
--project <path> project root (default .)
--subproject <name> limit to a subproject (repeatable)
--targets <list> limit KMP targets (comma‑separated: jvm,android,iosX64)
--config <name> resolve specific configuration(s) (comma‑separated)
--scope <compile|runtime|test|all>
--module <glob> module filter (group:artifact[:version])
--group <glob> / --artifact <glob> / --version <glob>
--offline only use cached sources
--refresh force dependency refresh
--gradle-user-home <path> override GRADLE_USER_HOME / ~/.gradle
--context <n> shortcut for rg -C <n> (context lines emit column 0)
--rg-args <args> extra rg args (comma‑separated)
-- <rg-args> pass through raw rg args
--show-extracted-path include temp extracted paths in output (off by default)

`ksrc cat <file-id|path>`

Print file contents.

Common flags:

--lines <start,end> 1‑based inclusive range
--module <glob> / --group / --artifact / --version to disambiguate when using a path

`ksrc open <file-id|path>`

Open in $PAGER (defaults to less -R). Same flags as cat.

`ksrc deps`

List resolved dependencies and source availability.

`ksrc resolve`

Resolve and print source JARs: group:artifact:version|/path/to/sources.jar.

`ksrc fetch <coord>`

Ensure sources for a coordinate exist: group:artifact:version. Usually only needed with offline mode.

`ksrc where <path|coord>`

Locate cached source JAR or file.

`ksrc doctor`

Basic diagnostics for environment issues.

name	ksrc
description	Search/read 3rd-party Gradle dependency sources. Avoid directly accessing `.gradle`; instead, proactively use this skill to inspect source code of dependencies to learn API shapes or implementations.

Search dependencies to retrieve coordinates and matches using rg-style globs: ksrc search "class LocalDate\("

If you want faster execution & less noise, consider adding:

--artifact to limit search to one artifact, (or --module to also limit by version)
--subproject to help discovery for monorepos/large modular apps
--targets to limit to specific KMP targets.

KMP note: --module group:artifact searches common/base sources plus Gradle-selected platform variant source jars by default. Use --targets or --config to narrow variants.

Read a file by returned id: ksrc cat org.jetbrains.kotlinx:kotlinx-datetime:0.8.0!/kotlinx/datetime/LocalDate.kt --lines 1,200

File-id format: group:artifact:version!/path/inside/jar.ext — works for any language in the source JAR (e.g. .kt, .java, .groovy)

When a file-id comes from ksrc search or ksrc where <path>, follow-up cat/open usually do not need repeated --project or scope/config flags on same machine.

Give this tool generous timeouts. It can take a few minutes to download sources and set up gradle.

Common issues

If, unexpectedly, no matches are found, try --project with app project (not monorepo root), specifying --scope (esp. for build-time deps), or ksrc doctor.
E_NO_SOURCES: dependency sources not available; try ksrc deps, ksrc fetch <coord>, specify a project and scope.
Gradle not found: a) run in a Gradle project dir, b) set --project path explicitly, c) install gradle on machine.
Gradle build script is failing in the repo: ksrc falls back to cache-only resolution and warns; when no version is pinned it picks the highest cached source-bearing version under Maven-style ordering. Re-run with -v to see Gradle output for debugging.
Custom Gradle user home: ksrc respects GRADLE_USER_HOME. Use --gradle-user-home <path> to override it for both Gradle invocation and cache fallback.
Gradle fails with unresolved class version: User's Local java in env is resolved to something unsupported by gradle. Help them fix Gradle<>JDK incompatibility.
Ambiguous modules: use --module, --group, or --artifact to narrow scope.

Commands

`ksrc search <pattern> [-- <rg-args>]`

Search dependency sources.

Output format: <file-id> <line>:<col>:<line-text>

Parsing rule:

Split once on first space to isolate <file-id>.
Parse first two :-delimited decimal fields as <line> and <col>.
Treat remainder verbatim as <line-text>; it may contain :.

With --show-extracted-path, output shape changes to: <file-id>\t<quoted-extracted-path>\t<line>\t<col>\t<quoted-line-text>

Common flags:

--all search across all resolved deps (default, slow)
--project <path> project root (default .)
--subproject <name> limit to a subproject (repeatable)
--targets <list> limit KMP targets (comma‑separated: jvm,android,iosX64)
--config <name> resolve specific configuration(s) (comma‑separated)
--scope <compile|runtime|test|all>
--module <glob> module filter (group:artifact[:version])
--group <glob> / --artifact <glob> / --version <glob>
--offline only use cached sources
--refresh force dependency refresh
--gradle-user-home <path> override GRADLE_USER_HOME / ~/.gradle
--context <n> shortcut for rg -C <n> (context lines emit column 0)
--rg-args <args> extra rg args (comma‑separated)
-- <rg-args> pass through raw rg args
--show-extracted-path include temp extracted paths in output (off by default)

`ksrc cat <file-id|path>`

Print file contents.

Common flags:

--lines <start,end> 1‑based inclusive range
--module <glob> / --group / --artifact / --version to disambiguate when using a path

`ksrc open <file-id|path>`

Open in $PAGER (defaults to less -R). Same flags as cat.

`ksrc deps`

List resolved dependencies and source availability.

`ksrc resolve`

Resolve and print source JARs: group:artifact:version|/path/to/sources.jar.

`ksrc fetch <coord>`

Ensure sources for a coordinate exist: group:artifact:version. Usually only needed with offline mode.

`ksrc where <path|coord>`

Locate cached source JAR or file.

`ksrc doctor`

Basic diagnostics for environment issues.