npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@rhighs-lab/looksee

v0.3.0

Published

A live, GitHub-style review of your uncommitted work, built for agentic development

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

rhighsrhighs

Keywords

gitdiffcode-reviewpull-requestcli

Readme

Install

curl -fsSL https://raw.githubusercontent.com/rhighs-lab/looksee/main/install.sh | bash

npm:

npm install -g @rhighs-lab/looksee

npx:

npx @rhighs-lab/looksee review .

Agent skill (teaches any supported agent to use looksee):

npx skills add rhighs-lab/looksee

From source:

git clone https://github.com/rhighs-lab/looksee && cd looksee
pnpm install
pnpm link --global

Use

cd some-repo
looksee review .
looksee status --pretty
looksee stop

looksee review starts a daemon in the invoked location, any of the looksee review commands are contextual for that the repo only.

Features

review

Live diff of the working tree. Every change since your last look is included updated live as files get new edit chunks.

Diff comparison modes include:

  • Session start: a snapshot of the workspace pinned when the server opened.
  • Last approval: the snapshot pinned when you last approved a review.
  • Working tree: HEAD to workspace, the classic git diff.
  • Branch: merge base with the detected base branch.
  • Any ref: a branch or tag against the workspace.

threads

Comments and suggestions.

submit review

Pending reviews, like GitHub.

layer colors

Layer colors: staged, unstaged and untracked edits inside a hunk are told apart at a glance.

file view

File view.

answer

Code answers. Ask an agent where something happens and it answers here, as code, instead of a list of paths.

looksee answer "who calls git()?" \
  --hit src/server/git/refs.ts:10-14 --why "every ref lookup funnels here"

Larger answers go in as JSON on stdin, which is the path an agent takes:

echo '{"question":"...","summary":"markdown","hits":[
  {"path":"src/a.ts","startLine":10,"endLine":20,
   "symbol":"readPrefs","role":"reads disk","why":"..."}]}' | looksee answer

Agents

looksee init writes a standing rule into the instruction file of every agent installed on the machine (CLAUDE.md, Codex's AGENTS.md, GEMINI.md, opencode), or into this repo's AGENTS.md with --local. The rule tells the agent to offer a review after a set of changes and how to work the comment loop. looksee agent prints the full guide.

Codex and other turn-based harnesses

A turn-based agent only runs while it is answering. Output from a process it left in the background is buffered, not delivered: it never starts a new turn. So looksee listen in the background is not monitoring, and the installed rule never asks for it.

The rule uses a bounded poll in the foreground instead:

looksee listen --not-me --pending --wait 60

It prints anything still unanswered, then blocks until one event arrives or the timeout ends, and exits. The agent acts, replies, and runs it again. When the round is still open as its turn ends, the agent says so and asks for a message to resume. A comment left while the agent is idle is picked up by the next poll, which the user's next message triggers.

Drop --wait only on a host that can wake an idle agent on process output; there the stream itself is the subscription.

CLI

| Command | What it does | | --- | --- | | looksee review [path] | Start the server for a repo and open the browser | | looksee review . --title <name> | Name this review in the browser tab | | looksee review . --scope <preset> | Open on session, working or branch | | looksee status | Server, pending reviews, open threads and session pins | | looksee stop | Shut down the server for this repo | | looksee ps | List the looksee servers running on this machine | | looksee listen | Print review events as JSON lines; --wait <s> returns after the first one | | looksee comments | List threads with replies and an expects hint | | looksee reply <id> [body] | Reply to a thread, body from the argument or stdin | | looksee resolve <id> | Mark a thread resolved | | looksee comment <file>:<line>[-<line>] <body> | Post a single comment outside a review | | looksee answer [question] --hit <file>:<line> | Publish a code answer as a navigable map | | looksee review start | Open a pending review for the actor | | looksee review comment <file>:<line> <body> | Add a draft to the pending review | | looksee review submit --verdict <v> [body] | Submit with comment, approve or request_changes | | looksee review discard | Drop the pending review and its drafts | | looksee review show | Print the pending review and its drafts | | looksee pin | Re-pin the session to the current workspace | | looksee scope [session\|working\|branch] | Set or print the default comparison | | looksee session end | End the session and drop its pins | | looksee agent | Print the agent guide | | looksee init | Add the looksee review rule to AGENTS.md | | looksee serve --repo . | Run the server in the foreground |

Development

CONTRIBUTING.md.

Credits

Inspired by prequel.

License

MIT (c) Roberto Montalti

Bundled fonts (Literata) are licensed under the SIL Open Font License 1.1.