From 47170cb4ff1d4a65de67df630d849f53770c9157 Mon Sep 17 00:00:00 2001 From: barkz Date: Sun, 16 Aug 2026 17:43:14 -0500 Subject: [PATCH 1/2] Add a Highlights section to the README Three bullets under the screenshot covering what landed recently, each linked to its PR and squashed merge commit: - installer and macOS Spotlight app (#11, e46d517) - OpenAPI incompatibility audit (#10, f81902d) - repo hygiene and stale-doc fixes (#12, 17199b5) Also adds Highlights to the Contents list. Co-Authored-By: Claude Opus 5 --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index d0bf617..ceae46b 100644 --- a/README.md +++ b/README.md @@ -8,8 +8,27 @@ A local, terminal-first client for the Glean Client REST API. Inspired by Claude ![Glean Code terminal screenshot](assets/glean_code_cli_example.png) +## Highlights + +- **One-command install, and a Spotlight-launchable macOS app** — `python3 install.py` builds a + single-file zipapp (~84 KB, still zero dependencies) and puts `glean` on your PATH, plus a + registered `Glean.app` so `Cmd+Space` → "Glean" opens the REPL. + [#11](https://github.com/barkz/glean-code-cli/pull/11) · + [`e46d517`](https://github.com/barkz/glean-code-cli/commit/e46d517) +- **Every REST call audited against Glean's published OpenAPI spec** — the new + [incompatibility report](incompat_report.md) documents 12 Client API divergences from spec + `0.9.0`, with locations and fixes. Indexing and Custom Metadata verified clean. + [#10](https://github.com/barkz/glean-code-cli/pull/10) · + [`f81902d`](https://github.com/barkz/glean-code-cli/commit/f81902d) +- **Repo hygiene fixes** — removed 35 tracked `__pycache__` artifacts, corrected stale docs + (the suite is 721 tests, not 604), and dropped a Spotlight ignore rule that macOS never + honored. + [#12](https://github.com/barkz/glean-code-cli/pull/12) · + [`17199b5`](https://github.com/barkz/glean-code-cli/commit/17199b5) + ## Contents +- [Highlights](#highlights) — what landed recently - [What you get](#what-you-get) - [Getting started](#getting-started) — install, alias, first run - [Coming soon](#coming-soon) From cd074425e1845bb4fab3f7f10bd866d83a515068 Mon Sep 17 00:00:00 2001 From: barkz Date: Sun, 16 Aug 2026 17:47:17 -0500 Subject: [PATCH 2/2] Rename README 'What you get' section to 'Overview' Co-Authored-By: Claude Opus 5 --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index ceae46b..868c4b7 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ A local, terminal-first client for the Glean Client REST API. Inspired by Claude ## Contents - [Highlights](#highlights) — what landed recently -- [What you get](#what-you-get) +- [Overview](#overview) - [Getting started](#getting-started) — install, alias, first run - [Coming soon](#coming-soon) - [Commands at a glance](#commands-at-a-glance) @@ -45,7 +45,7 @@ A local, terminal-first client for the Glean Client REST API. Inspired by Claude - [Changelog](CHANGELOG.md) — release history - [License](#license) -## What you get +## Overview - **Every major Glean Client API surface as a slash command** — chat, search, agents, tools, docs, people, shortcuts (Go Links), answers, summarize, verification, messages, activity, announcements, collections, pins, and insights - **Near-complete Indexing API coverage** across read/debug, single-record write, bulk, and process-all tiers — including a debug toolkit that answers "is this doc uploaded?" and "why can't user X see doc Y?" without leaving the REPL. See [docs/INDEXING.md](docs/INDEXING.md)