glimmer-cli for Muse Glimmer and Spark

# glimmer-cli

Local CLI for **Meta's Glimmer** + **Muse Spark 1.2** — with a reproducible tool-use eval harness.

> **Status (2026-08-16 20:30 UTC):** Muse Glimmer 30B shipped Aug 10 — live on Ollama `muse-glimmer` 18GB Q4_K_M (27.9B, 131K, tools/vision/thinking) via `ollama pull muse-glimmer` (see [`docs/research/glimmer-availability-2026-08-16.md`](docs/research/glimmer-availability-2026-08-16.md)). Repo defaults to `GLIMMER_MODEL=muse-glimmer` with `llama3.1:8b` fallback. Native CLI: `glimmer` (after `pnpm link --global` or `ln -sf $PWD/bin/glimmer ~/.local/bin/glimmer`).

![CI](https://img.shields.io/badge/ci-pnpm%20test%20%2B%20mock%20eval-blue) ![Stack](https://img.shields.io/badge/stack-TS%20%2B%20tsx%20%2B%20vitest%20%2B%20biome-38bdf8) ![License](https://img.shields.io/badge/license-MIT-green)

## Quick start

```bash
git clone https://github.com/schererstefan/glimmer-cli.git
cd glimmer-cli
pnpm install

# Native CLI (no pnpm prefix needed after link)
ln -sf $PWD/bin/glimmer ~/.local/bin/glimmer  # or: pnpm link --global (adds $PNPM_HOME/bin to PATH via pnpm setup)
glimmer --help
glimmer --provider mock "What's the weather in Seattle tomorrow?"
glimmer --provider mock            # interactive REPL, --verbose for tool traces

# pnpm wrappers still work
pnpm cli --provider mock "What's the weather in Seattle tomorrow?"
pnpm test                           # vitest — all mocked, no network
pnpm eval --mock                    # runs 45 cases against mock, writes evals/COMPARISON.md
```

## With a local model (Ollama) — Muse Glimmer 30B

```bash
# Install Ollama if needed
brew install ollama
brew services start ollama  # or: ollama serve &

ollama pull muse-glimmer            # 18GB Q4_K_M 27.9B — primary
glimmer --provider glimmer "What's the weather in Seattle tomorrow?"
glimmer --provider glimmer --model muse-glimmer --verbose "Book a meeting..."

# also available
ollama pull llama3.1:8b             # 4.9GB fallback
glimmer --provider glimmer --model llama3.1:8b "Hello"
pnpm glimmer:setup                  # pulls $GLIMMER_MODEL (default muse-glimmer) or fallback
pnpm glimmer:setup --dry-run
```

Hardware: `muse-glimmer Q4_K_M` ≈ 18 GB RAM/disk, `8B Q4_K_M` ≈ 5 GB; `70B Q4` ≈ 40 GB (not for base Mac). Glimmer shows 15%/85% CPU/GPU via `ollama ps`.

## With Muse Spark 1.2

```bash
cp .env.example .env.local  # add MUSE_SPARK_API_KEY and MUSE_SPARK_BASE_