Add the demo GIF - #41
Merged
Merged
Conversation
The README had a placeholder where the demo should be, and the demo is the thing a community post lives or dies on. Recorded against invented sessions, never the real ~/.claude. That is the whole reason record-demo.sh exists: it builds a throwaway HOME of 52 fake sessions across six projects, points agsearch at it, and records that. A GIF is the most-shared artifact this repo produces and it must not carry a real transcript. The query is misspelled on purpose. "conection pool" is what someone half-remembering a session actually types, and it exercises the subsequence fallback, so the GIF demonstrates the tagline rather than restating it. Verified before recording that the typo still ranks the right session first, along with "webook retrys". Four things the first takes got wrong, all fixed in the fixture rather than hidden: shell setup leaking into frame one, PATH losing /usr/bin so clear and python3 vanished, every row flagged live because the fixtures were written seconds earlier (mtimes are now backdated), and every row reading "orig dir gone" because the recorded cwds did not exist. demo.tape carries a placeholder instead of a machine path, so the committed tape has nothing local in it. twine check still passes: the README is the PyPI long description, so the image is an absolute raw.githubusercontent URL.
The README had a placeholder where the demo should be, and the demo is what a community post lives or dies on. Two beats. The first is an exact query whose words appear in the conversation but not in the session's title, so the badge stays clean and it demonstrates the actual claim: found by content, not by name. The second is the same idea misspelled, because that is what people type. Order matters -- a typo can only ever produce a "partial" badge, so leading with it reads as a hedge rather than as typo tolerance. It stops at the result. What Enter does next is Claude Code's own screen, and a UUID on a command line is not worth the seconds. Recorded against 52 invented sessions in a throwaway HOME, never a real ~/.claude: a demo GIF is the most-shared thing here and must not carry a real transcript. The recording setup is kept outside the repo, which is what zoxide, bat and fzf all do -- they ship the GIF and nothing else. The README is also the PyPI long description, so the image is an absolute raw.githubusercontent URL rather than a relative path, which would render broken there.
devcodes9
changed the title
"alibrry" and "migration OF alibrary" carried an internal project name into a public repo. It reads as noise to anyone outside, and it points back at client work. Replaced with "conection", which is the typo the demo GIF types, so the ranking prose now explains what the recording shows.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Replaces the placeholder in the README with a recorded demo.
The GIF runs two searches over a 52-session corpus:
backoff jitter— neither word appears in the session's title, so the hit comes from the conversation itself.conection pool— misspelled, and still ranks the right session first.It ends at the result rather than resuming, since what follows is Claude Code's own screen.
Also in this PR:
docs/demo.tape. The recording setup is kept outside the repo.alibrrytypo example in the README andagsearchwithconection, so the ranking notes match what the GIF shows.The GIF is recorded against a synthetic corpus, never real transcripts. The README is also the PyPI long description, so the image uses an absolute URL rather than a relative path. 864K, 12.7s. 101 tests pass.