# Scopelet

> Query files and repositories, recover compressed evidence, and configure Scopelet.

- Skill: `maxgfr/scopelet` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add maxgfr/scopelet`
- Raw SKILL.md: https://api.skillmd.com/api/skills/maxgfr/scopelet/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: maxgfr (https://skillmd.com/u/maxgfr)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/maxgfr/scopelet

---


# Scopelet

Use `"$SCOPELET_BIN"` when set; otherwise `scopelet` or
`node <this-skill>/scripts/scopelet.mjs`.
Small known files and edits use native tools. Installed hooks work without this
skill; avoid stacking Scopelet with another output wrapper.

Compute the result before reading bulk data:

```sh
scopelet query --repo . --find validateToken --context 5
scopelet query --file events.jsonl --format jsonl --filter /status --equals '"failed"' --group /suite --output compact
scopelet run --auto -- npm test
```

Unknown JSON fields: inspect at most 2 KiB first. `--find` is literal.
Read [queries.md](references/queries.md) for regex, composed operations,
structured data or recovery. Partial results cannot establish absence or an
exhaustive count. Recover exact source bytes before editing abridged evidence.

`scopelet mode default|caveman|off` controls installed hooks and response style.
Caveman uses minimal telegraphic replies while preserving necessary information;
saved documents use normal prose. `--mode ultra` separately abridges CLI views.
Read [setup.md](references/setup.md) for automatic installation, host coverage,
mode details, failures or optional adapters. Byte savings are not session savings.

MIT · [maxgfr / support](https://github.com/maxgfr/scopelet/issues).