Maven repositories

[matejcerny]

• add support for configuring extra Maven repositories
• rewrite SKILL.md to be more concise / token efficient

---

(I've been using this updated skill for more than a week, so I can confirm it works correctly)

[rochala]

LGTM but before I merge I want to run skill creator skill to double check those changes

[rochala]

Skill creator suggested leaving example block because it tell agent how it can grep it further etc.

[rochala]

Skill-creator suggested that leaving a reason will hold better and have better results

[rochala]

We have to be extra careful with metals.

I got some comments / feedback that when they used it with IJ, it tried to install metals or something because of our skill. I'd be very explicit here so something more like:

Project classpath:
Metals MCP server if available > cellar project-aware commands

Compile, references, tests, formatting are not supported by cellar

[matejcerny]

Rebased. I removed the SKILL.md refactoring to unblock it.

Here is the "backup", feel free to cherry-pick it if you want. I use it for almost a month now an it works as expected (tested with Claude Sonnet 5, Opus 5, GPT Luna, Sol and Grok 4.5), no need for examples. One thing I didn't test is IJ compatibility since I don't have any agentic plugin there.

SKILL.md

---
name: cellar
description: >
  Look up the public API of any JVM dependency (Scala 3, Scala 2, Java) from
  the terminal — type signatures, members, docs, and source as Markdown, no
  JAR unpacking needed. Use this skill whenever you need to call an unfamiliar
  library method, explore a package's types, or check a dependency's API.
  Prefer cellar over Metals MCP only for looking up external dependency APIs
  (`cellar get-external` vs Metals `inspect`/`get-docs`) — cellar needs no
  project import and queries any published Maven artifact.
---

# Cellar

Look up JVM dependency APIs from the terminal. NEVER download or unpack JARs manually.
If `cellar` isn't on PATH: https://github.com/VirtusLab/cellar#installation

## Project-aware commands (run from project root)

Queries the current project and its dependencies. Auto-detects Mill, sbt, scala-cli.

```sh
cellar get [--module <name>] <fqn>       # signature, members, docs
cellar list [--module <name>] <package>  # symbols in a package or class
cellar search [--module <name>] <query>  # case-insensitive substring search
```

- Mill/sbt: `--module` required (e.g. `--module core`)
- scala-cli: omit `--module`
- `--no-cache` — re-extract classpath from the build tool

## External (any Maven coordinate)

```sh
cellar get-external <coordinate> <fqn>
cellar list-external <coordinate> <package>
cellar search-external <coordinate> <query>
cellar get-source <coordinate> <fqn>
cellar deps <coordinate>
cellar meta <coordinate>
```

- Coordinates must be explicit: `group:artifact_3:version` (no `::` shorthand)
- sbt plugins: full Scala + sbt suffix, e.g. `org.scala-native:sbt-scala-native_2.12_1.0:latest`
- Full Scala-version artifacts: e.g. `group:artifact_3.3.8:version`
- Version may be `latest`
- `-r <url>` — extra Maven repository (repeatable). Only for a repository that is not already
  listed under `maven.repositories` in `~/.cellar/cellar.conf` or `.cellar/cellar.conf`; those
  apply automatically. Never ask for, inspect, or pass repository credentials.

## Flags for both

- `-l N` — limit `list`/`search` results (default 50) or `get` members
- `--hide-inherited` / `--group-inherited` — control inherited members on `get`
- `--java-home <path>` — override JRE classpath

## Workflow

1. Package/name unknown → `search` / `search-external`
2. Package or enclosing class known, type unknown → `list` / `list-external`
3. Type known → `get` / `get-external`
4. Implementation needed → `get-source`
5. Coordinate/POM only → `meta` or `deps`

## Examples

```sh
cellar get-external org.typelevel:cats-core_3:2.10.0 cats.Monad
cellar get-external --hide-inherited org.typelevel:cats-core_3:2.10.0 cats.Monad
cellar list-external io.circe:circe-core_3:0.14.6 io.circe
cellar search-external org.typelevel:cats-core_3:2.10.0 flatMap
cellar get-source org.typelevel:cats-core_3:2.10.0 cats.Monad
cellar deps org.typelevel:cats-effect_3:3.5.4
cellar get --module lib cats.Monad
```

## Metals vs cellar

cellar reads APIs, nothing else.
External coordinate → cellar.
Project classpath → Metals `inspect`/`get-docs`/`glob-search`, or cellar's project-aware commands when Metals is unavailable.
Compile, references, tests, formatting → Metals.

## Output

stdout is Markdown, stderr is diagnostics. Exit 0 success, 1 error.