videlov /

headroom

Your 5-hour and weekly Claude usage limits in the macOS menu bar, with alerts before you run out

A new way for AI to search for data

View on GitHub

1GitHub stars

Swift, shell

What XERJ indexed

Snapshot

Whole repository

The whole repository at commit c17a50074b (2026-10-20).

Selected work

Vladimir Videlov
@videlov

“Weekly ring in the menu bar, used-up limits explained, cookie kept of…”. 20 files, 1,114 lines in Sources, Tests, scripts.

Licence

The repository

MIT

Checked by a person at the pinned commit.

The XERJ corpus

MIT, with credit

The author agreed by email on 2026-10-22. Same terms as the repository. Answers name the repo, the commit and the file:line.

in licence reviewnot in the hub yetsuggested use: adapt with attribution

Example questions

What does Sources do in headroom?

The prompt

Paste it into your AI agent. It clones videlov/headroom at the pinned commit and indexes it on your machine.

Search the GitHub repository videlov/headroom with XERJ (https://hub.xerj.org/corpus/videlov--headroom).
Run these in a shell, in order, and check each result before the next:
1. xerj --help  (success: it prints usage). If xerj is missing: curl -fsSL https://xerj.org/get | sh
2. git clone https://github.com/videlov/headroom headroom && git -C headroom checkout c17a50074b51190292ed7308929454661d65af4d
3. Start a local node and leave it running: xerj --insecure --data-dir ./xerj-data
4. xerj autoindex ./headroom --url http://127.0.0.1:9200 --prefix headroom --progress plain
5. xerj autoindex map --url http://127.0.0.1:9200
Then answer my question from the indexed files and cite the ax_path of every hit. Query syntax: https://xerj.org/llms.txt
Licence: MIT. Keep the copyright notice and credit the authors.

Vladimir Videlov AI, prompts and agents corpora

Selected work and consent: the XERJ registry.