CLI reference / Binary and models
cumaru model
List, download and enable, or release the optional local context encoder.
Synopsis
cumaru model list
cumaru model pull <name>
cumaru model release Arguments and options
| Argument or option | Meaning |
|---|---|
list | Read the fixed model catalog from GitHub main; print names, sizes, and licenses. |
pull <name> | Download, verify, and enable a catalog model, or reuse a verified local package. |
release | Disable the cached encoder without deleting files; context uses the lightweight scorer. |
Side effects
- Writes: pull publishes a package under ~/.cumaru/<name>/. release writes an empty .released marker. No project files change.
- Network: list and pull read GitHub main; pull downloads about 35 MB for bge-micro-v2. release is offline.
Behavior
- The catalog currently contains only bge-micro-v2. Arbitrary model IDs, URLs, and local imports are not supported.
- pull verifies sizes and SHA-256 before publishing. An existing invalid or different package is rejected and kept.
- Nothing downloads automatically; context never downloads.
Example
cumaru model list Failures
- A missing catalog or network failure is an error. Download or verification failures create no cache state.
Sources: docs/model.md; cumaru model --help of CLI 0.15.3.