--- name: ksrc description: CLI for searching\/reading Kotlin dependency sources from a Gradle project. Use when you need to locate\/inspect 3rd-party Gradle libraries. --- ## How to use: Note: Give this tool generous timeouts. It can take a few minutes to download sources if needed and set up gradle. 1. Search dependencies to retrieve coordinates and matches: `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. 2. Read a file by returned id: `ksrc cat org.jetbrains.kotlinx:kotlinx-datetime:0.6.1!\/kotlinx\/datetime\/LocalDate.kt --lines 1,200` ## Common issues - If, unexpectedly, no matches are found, try `cd` ing into a relevant project (if in composite build), specifying a scope `--scope` (esp. for build-time deps), or `ksrc doctor`. - `E_NO_SOURCES`: dependency sources not available; try `ksrc deps`, `ksrc fetch `, specify a project and scope. - Gradle not found: run in a Gradle project or set `--project` to the root. - Gradle resolution failures: `ksrc` falls back to cache-only resolution and warns; re-run with `-v` to see Gradle output for debugging. - Gradle files 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 [-- ]` Search dependency sources. Output format: ` ::` Common flags: - `--all` search across all resolved deps (default when no selector is provided) - `--project ` project root (default `.`) - `--subproject ` limit to a subproject (repeatable) - `--targets ` limit KMP targets (comma‑separated: `jvm,android,iosX64`) - `--config ` resolve specific configuration(s) (comma‑separated) - `--scope ` - `--module ` module filter (`group:artifact[:version]`) - `--group ` \/ `--artifact ` \/ `--version ` - `--offline` only use cached sources - `--refresh` force dependency refresh - `--context ` shortcut for `rg -C ` (context lines emit column `0`) - `--rg-args ` extra rg args (comma‑separated) - `-- ` pass through raw rg args - `--show-extracted-path` include temp extracted paths in output (off by default) ### `ksrc cat ` Print file contents. Common flags: - `--lines ` 1‑based inclusive range - `--module ` \/ `--group` \/ `--artifact` \/ `--version` to disambiguate when using a path ### `ksrc open ` 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 ` Ensure sources for a coordinate exist: `group:artifact:version`. ### `ksrc where ` Locate cached source JAR or file. ### `ksrc doctor` Basic diagnostics for environment issues. ## File-id format `group:artifact:version!\/path\/inside\/jar.kt`