Kunal-5402

Hooklens — Development skill for Claude Code

Development community

See what your coding agents do: tool calls, commands, files, and tokens from Claude Code, Codex, and Cursor.

How to install Hooklens

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Kunal-5402/hooklens and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Hooklens does

See what your coding agents do: tool calls, commands, files, and tokens from Claude Code, Codex, and Cursor. Local-first.

Alternatives in Development

Ccusage — CLI for analyzing Claude Code/Codex usage from local JSONL files 11.8k ★
Code Review Graph — Local knowledge graph for Claude Code 3.7k ★
Opik Openclaw — 🦞 Official plugin for OpenClaw that exports agent traces to Opik 725 ★

README

hooklens

**See what your coding agent actually did.**

Every tool call, shell command, file change, MCP call, and token, from Claude Code, Codex, and Cursor. On a timeline and a graph, on your machine.

[![CI](https://github.com/Kunal-5402/hooklens/actions/workflows/ci.yml/badge.svg)](https://github.com/Kunal-5402/hooklens/actions/workflows/ci.yml) [![PyPI](https://img.shields.io/pypi/v/hooklens?cacheSeconds=3600)](https://pypi.org/project/hooklens/) [![Python](https://img.shields.io/badge/python-3.11%2B-blue)](pyproject.toml) [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)

![hooklens session timeline](https://raw.githubusercontent.com/Kunal-5402/hooklens/main/assets/timeline.png)

Why hooklens

Coding agents run commands, edit files, and call tools faster than you can read the transcript. hooklens records what happened through the agents' own hooks, so you can answer questions like:

Which files did the agent change, and which did it only read?
What shell commands ran, and which ones failed?
Which MCP servers and tools did it use?
Where did the time go, and how many tokens did the session cost?

It is a single Python package with **no dependencies**. Data stays in a local SQLite file, and the UI is a local web page. **Nothing leaves your machine.**

Features

Timeline of every tool call, with duration and status. Long idle gaps are compressed.
Graph of the session: tools, programs, files, MCP servers, and how often each was used.
Event log with the input and a response excerpt of every call.
Summary of files changed, files read, commands, and MCP servers.
Tokens and model from the agent's transcript.
Live view that updates while the agent works.
One view for three agents. Claude Code, Codex, and Cursor events are normalized to one schema.