Repository navigation
Obserf finds public conversations where mentioning your project would actually help someone, ranks them, and drafts what to say. It never posts. You read the thread, check the venue's rules, edit the draft, and post it yourself.
It exists for maintainers who have no time to promote what they build. Search turns up hundreds of loosely related pages, and working out which are active, relevant and open to a maintainer's reply takes longer than writing the reply. Obserf turns that reading into a short, ranked inbox with a reason beside every finding. It runs on your machine, on your Claude Code subscription, with no account and no API key.
Get started
You need Bun 1.4+ and Claude Code signed in with a subscription.
bunx @obserf/cli init ~/dev/marketing # create a workspace
cd ~/dev/marketing && bun install
$EDITOR projects/example.ts # describe your project, write real queries
bun run obserf scan --dry-run # discover and gate only: no model calls
bun run obserf scan # let Claude assess what survived
bun run obserf serve # review at http://127.0.0.1:4000Hacker News and GitHub work without credentials. The README covers Reddit, Brave and writing a good profile.
What's new in 0.3
The review inbox is redesigned so you can work through a queue quickly, mostly from the keyboard, and always tell the model's opinion apart from the facts and from your own notes.
- Read in the order you decide. Each finding shows the model's verdict first, then the page's own words, then the score. "Why 55?" shows exactly how the score was calculated.
- Every action has a key. A bar at the bottom shows each decision with its key. Press ? to see all shortcuts, and [ ] to switch tabs.
- Undo right where you decided. After each decision a small toast offers Undo, the dismissal reasons and a "where did you post it?" field.
- Scan health at a glance. A pill in the header shows how old your scans are and whether any source was skipped or failed. Click it for the full report.
- The list holds still. If a scan finishes while you're reviewing, a banner offers to refresh instead of reshuffling the list under you.
- Empty means explained. An empty tab says why: zero-scored findings hidden, nothing new, or a scan that didn't see everything.
- Scores are plain numbers. The old green and amber colours suggested precision the ranking doesn't have. Only a score forced to zero by a hard rule is marked, and the rule is named.
- Light and dark themes, with contrast and screen-reader support checked in both.
The hide reasons toggle is now called Hide judgment. It works the same way.
Upgrading from 0.2
bun add @obserf/cli@0.3.0Then restart obserf serve. There are no database changes in this release.
Full changelog: v0.2.0...v0.3.0