{"id":49170398,"url":"https://github.com/juxt/glance","last_synced_at":"2026-04-22T18:04:13.852Z","repository":{"id":339769960,"uuid":"1163275869","full_name":"juxt/glance","owner":"juxt","description":"Command output summariser with filters, built for LLMs","archived":false,"fork":false,"pushed_at":"2026-02-24T09:43:41.000Z","size":66,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-24T15:36:23.372Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/juxt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-21T11:27:09.000Z","updated_at":"2026-02-24T09:43:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/juxt/glance","commit_stats":null,"previous_names":["akeboshiwind/glance","juxt/glance"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/juxt/glance","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Fglance","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Fglance/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Fglance/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Fglance/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/juxt","download_url":"https://codeload.github.com/juxt/glance/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Fglance/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32148198,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T17:06:48.269Z","status":"ssl_error","status_checked_at":"2026-04-22T17:06:19.037Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-22T18:04:12.549Z","updated_at":"2026-04-22T18:04:13.840Z","avatar_url":"https://github.com/juxt.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# glance — LLM-optimized output summarizer\n\n[![PyPI](https://img.shields.io/pypi/v/glancecli?label=pypi)](https://pypi.org/project/glancecli/)\n[![Go tests](https://github.com/juxt/glance/actions/workflows/test.yml/badge.svg)](https://github.com/juxt/glance/actions/workflows/test.yml)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\nLLMs read every token of command output with equal attention, unlike humans who skim head/tail and scan for patterns. `glance` gives LLMs a human-like \"skim\" — pipe output in, get a token-efficient summary with head/tail + regex-matched lines, plus an ID to drill deeper.\n\n## Install\n\n```sh\n# Install permanently (puts `glance` on PATH)\nuv tool install glancecli\n\n# One-shot without installing\nuvx --from glancecli glance\n\n# Or with Go\ngo install github.com/juxt/glance@latest\n```\n\nClaude Code plugin:\n```\n/plugin marketplace add juxt/glance\n/plugin install glance\n```\n\n## What it does\n\n```\n$ seq 500 | glance -n 3\n  1: 1\n  2: 2\n  3: 3\n498: 498\n499: 499\n500: 500\n--- glance id=20260219-143022-a3f8b1c0 | 500 lines | showing 6 | sections: 1-3, 498-500 ---\n```\n\n```\n$ (seq 100; echo \"ERROR db connection refused\"; seq 200) | glance -n 3 -p errors\n  1: 1\n  2: 2\n  3: 3\n101: ERROR db connection refused\n299: 198\n300: 199\n301: 200\n--- glance id=20260219-143025-b7c2e4f1 | 301 lines | showing 7 | sections: 1-3, 101, 299-301 ---\n```\n\nThe stored capture can be drilled into:\n```\n$ glance show 20260219-143025-b7c2e4f1 -a 101 2\n 99: 99\n100: 100\n101: ERROR db connection refused\n102: 1\n103: 2\n--- glance show 20260219-143025-b7c2e4f1 | 301 lines | showing 5 | sections: 99-103 ---\n```\n\n## Design decisions\n\n- **Single static binary** — compiled Go, no runtime dependencies. Cross-compiled for Linux, macOS, and Windows (amd64 + arm64).\n- **OR semantics** — all matchers (filters + presets) OR together. Head/tail always shown. This is the most useful behavior for scanning output: \"show me the start, end, and anything interesting\".\n- **Persistent storage** — captures stored in `$XDG_CACHE_HOME/glance/captures/` with timestamp + hex IDs (e.g. `20260219-143022-a3f8b1c0`). Full ID required for `glance show` — use `glance list` to find IDs.\n- **No metadata files** — line count and age derived from the stored file itself (`wc -l`, `stat`).\n- **Built-in + user presets** — three hardcoded presets (errors, warnings, status) cover common patterns. User presets stored in `~/.config/glance/presets.csv` as CSV. Use `(?i)` prefix for case-insensitive matching.\n\n## Usage\n\nSee `glance help` for complete documentation. Key commands:\n\n| Command | Description |\n|---------|-------------|\n| `cmd \\| glance` | Head 10 + tail 10 |\n| `cmd \\| glance -n 5` | Head 5 + tail 5 |\n| `cmd \\| glance -f 'regex'` | + regex filter matches |\n| `cmd \\| glance -p errors` | + preset filter |\n| `glance show \u003cid\u003e` | Full stored output |\n| `glance show \u003cid\u003e -l 50-80` | Line range |\n| `glance show \u003cid\u003e -f 'regex'` | Filter stored output |\n| `glance show \u003cid\u003e -p errors` | Filter with preset |\n| `glance show \u003cid\u003e -a N C` | Context around line N |\n| `glance list` | List stored captures |\n| `glance clean` | Purge captures |\n| `glance presets list` | Show all presets |\n| `glance presets add \u003cname\u003e \u003cre\u003e [desc]` | Add user preset |\n| `glance presets remove \u003cname\u003e` | Remove user preset |\n\n\nPreset names must be alphanumeric (plus hyphens and underscores). Use `(?i)` prefix in regex for case-insensitive matching:\n\n```sh\nglance presets add deploys '(?i)deploy|release|rollout' 'Deployment events'\n```\n\n## Testing\n\n```\ngo test ./...\n```\n\n## Files\n\n- `main.go` — entry point and CLI\n- `*_test.go` — integration and unit tests\n- `.github/workflows/publish.yml` — PyPI release workflow\n- `README.md` — this file\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuxt%2Fglance","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuxt%2Fglance","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuxt%2Fglance/lists"}