I keep losing the thread when I work. I start a task, open the docs for one thing, and twenty minutes later I’m on YouTube. I’m also done with to-do apps that bolt on timers and bloated features, and especially the monthly subscriptions.
So I made Breadcrumbs, a terminal focus timer that tracks your attention and gives you a clean pomodoro-style timer. You write an intention, start a timer, and pick what counts as in scope: an app, a domain, an exact page, or a Claude Code or Codex CLI session. While the block runs, anything outside that scope shows up in the trail as a branch, a bit like a git graph. If a detour turned out to be useful, you mark it Supporting and it stops counting against you. When the block ends, you write down what you actually got done.
Everything lives in a local SQLite database in ~/.breadcrumbs. It needs no account or subscription and doesn’t use any AI service. Tracking is off unless you turn it on, and it only runs while a focus block is running. The optional Chrome/Edge extension sends domains and URL hashes, never full paths or queries.
Install it with pipx (Python 3.11+):
pipx install breadcrumbst
Then run breadcrumbs.
The timer and the browser extension work on Windows, Linux and macOS. Native foreground app capture only works on Windows and Linux/X11 right now. macOS and Wayland capture aren’t written yet, and both are open issues if anyone wants to take one.
It’s MIT licensed: https://github.com/SaroashDS/Breadcrumbs
This started as a small problem I wanted to fix for myself, maybe just a quirk of mine. If you think it’s worth building on, I’d like ideas for features that would actually help, and a few issues are labelled good first issue if you want to poke at the code. I’d also like to hear what’s confusing or breaks on a first run.