finos/morphir-scala / .claude/skills/squire
squire
VerifiedUse when morphir-scala work needs environment diagnostics or build/network/sandbox unblocking; reference repository management; branch lifecycle refresh after squash-merging a target branch into main; Morphir IR spec/schema sync or export; or task-tracking configuration and beads mode resolution.
references/cellar.md
View on GitHub# Squire use-cellar — JVM API Inspection
[Cellar](https://github.com/VirtusLab/cellar) is a CLI tool that queries the public API of any Maven JVM dependency — symbol signatures, package listings, name search, and dependency trees. Squire wraps it with project-specific repository configuration and coordinate aliases.
---
## Prerequisites
### Installation
Cellar is managed via mise. Check if it is installed:
```bash
which cellar && cellar --version
```
If missing, install via mise:
```bash
mise install github-VirtusLab/cellar
```
### System temp write access
Cellar writes temp `.tasty` files under the JVM's active `java.io.tmpdir`. If you hit `Operation not permitted`, run `/squire doctor` to probe that effective JVM path.
Use `JAVA_TOOL_OPTIONS` for the Java probe. Pass the verified path to Cellar with `--temp-directory`; the wrapper validates it and configures the native executable. See the doctor reference for the exact commands.
### Private Maven repositories (optional)
For dependencies not on Maven Central, create a local settings file from the template:
```bash
cp .config/squire/settings.local.yaml.template .config/squire/settings.local.yaml
```
Then add your Maven mirror URLs to `settings.local.yaml` — it is gitignored. The wrapper loads it automatically. Without it, only Maven Central is used.
---
## Using the wrapper
All Cellar queries for this project should go through Squire, which automatically adds the internal Maven repositories and supports coordinate aliases for common project dependencies.
```bash
${CLAUDE_PLUGIN_ROOT}/squire cellar <command> <coordinate> [args] [--temp-directory "/absolute/path"]
```
### Commands
**`get`** — Get all members of a type:
```bash
${CLAUDE_PLUGIN_ROOT}/squire cellar get <coordinate> <fully.qualified.Symbol>
${CLAUDE_PLUGIN_ROOT}/squire cellar get <coordinate> <fully.qualified.Symbol> --hide-inherited
```
**`search`** — Substring search for symbol names:
```bash
${CLAUDE_PLUGIN_ROOT}/squire cellar search <coordinate> <query>
${CLAUDE_PLUGIN_ROOT}/squire cellar search <coordinate> <query> --limit 20
```
**`deps`** — Show the dependency tree:
```bash
${CLAUDE_PLUGIN_ROOT}/squire cellar deps <coordinate>
```
---
## Coordinate aliases
The wrapper accepts short aliases for common project dependencies:
| Alias | Resolves to |
| ----- | ----------- |
| `case-app:2.1.0` | `com.github.alexarchambault:case-app_3:2.1.0` |
| `kyo-case-app` | `io.getkyo:kyo-case-app_3:1.0.0-RC5` |
| `kyo-schema` | `io.getkyo:kyo-schema_3:1.0.0-RC5` |
| `kyo-zio` | `io.getkyo:kyo-zio_3:1.0.0-RC5` |
| `zio:2.1.26` | `dev.zio:zio_3:2.1.26` |
| `zio-cli` | `dev.zio:zio-cli_3:0.8.1` |
| `mill-scalalib` | `com.lihaoyi:mill-scalalib_3:0.12.0` |
| `scala3-library` | `org.scala-lang:scala3-library_3:3.8.4` |
Full Maven coordinates are also accepted directly:
```bash
${CLAUDE_PLUGIN_ROOT}/squire cellar get "dev.zio:zio_3:2.1.26" "zio.ZIO"
```
---
## Common queries for this project
### case-app — CLI parsing
```bash
# All members of CommandsEntryPoint (the entry point base class)
${CLAUDE_PLUGIN_ROOT}/squire cellar get case-app:2.1.0 caseapp.core.app.CommandsEntryPoint
# Help[T] — what methods are available for customising help output
${CLAUDE_PLUGIN_ROOT}/squire cellar get case-app:2.1.0 caseapp.core.help.Help --hide-inherited
# Search for annotation types (HelpMessage, Name, AppName, etc.)
${CLAUDE_PLUGIN_ROOT}/squire cellar search case-app:2.1.0 "AppName"
${CLAUDE_PLUGIN_ROOT}/squire cellar search case-app:2.1.0 "HelpMessage"
```
### kyo — Effect system and CLI
```bash
# KyoCommand — the base class for CLI commands
${CLAUDE_PLUGIN_ROOT}/squire cellar get kyo-case-app "kyo.KyoCommand"
# What run overloads are available
${CLAUDE_PLUGIN_ROOT}/squire cellar search kyo-case-app "run"
# Dependency tree — what kyo-case-app pulls in
${CLAUDE_PLUGIN_ROOT}/squire cellar deps kyo-case-app
```
### ZIO — Effect system
```bash
# ZIO type members
${CLAUDE_PLUGIN_ROOT}/squire cellar get "zio:2.1.26" "zio.ZIO"
# Search for a specific method
${CLAUDE_PLUGIN_ROOT}/squire cellar search "zio:2.1.26" "provide"
```
---
## Why cellar instead of reading sources?
Cellar queries compiled TASTy/bytecode — it shows the exact public API as shipped in the published artifact, including synthetic methods, inlined definitions, and extension methods that may not be obvious from source. It is faster than downloading sources jars and grepping, and works even when sources aren't available.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |