---
name: cielara-usage
description: Flush buffered Cielara Code telemetry to the portal, then display local usage stats (searches enriched, files added, tokens saved, latency). Use when asked to show Cielara usage, stats, or telemetry.
metadata:
  short-description: Cielara Usage
---

# Cielara Usage

Push any locally-buffered usage events to the portal, then show the local usage stats summary.

Run the following shell command and display the output to the user exactly as returned:

```bash
cielara telemetry-flush --once >/dev/null 2>&1 || true; cielara stats
```

- `cielara telemetry-flush --once` flushes one batch of buffered telemetry
  (`~/.cielara/telemetry.ndjson`) to the portal `/v1/telemetry` endpoint before
  reading stats. Failures (no auth, portal down) are non-fatal — stats are still
  shown.
- `cielara stats` prints the local usage summary: % searches enriched, files
  added to context, estimated tokens saved (~25% of tokens our enrichment
  injected), how files were related, and latency.

Use the global `cielara` binary on PATH (not `node bin/cielara.js`, which is
cwd-relative and breaks when run from another directory). Do not add commentary.
Just show the stats output.
