silouone

Clens

Name: Clens
Author: silouone

Development community

SOURCE https://github.com/silouone/clens

Description

Claude Code session capture and analysis. Trace tool calls, detect backtracks, analyze decisions, track edit chains, and measure plan drift. Local-first, zero-dependency observability.

Installation

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

README

cLens — Session Observability for Claude Code

[![npm](https://img.shields.io/npm/v/%40silou%2Fclens)](https://www.npmjs.com/package/@silou/clens) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![CI](https://github.com/silouone/clens/actions/workflows/ci.yml/badge.svg)](https://github.com/silouone/clens/actions/workflows/ci.yml)

**Local-first session capture and analysis for Claude Code agents.** See what your agent actually did — every tool call, backtrack, decision, and reasoning step — then explore it all in a browser dashboard. Zero network, zero server, zero telemetry.

30-second quickstart

npm install -g @silou/clens   # or: bun install -g @silou/clens

![cLens web dashboard](.github/assets/dashboard-sessions.png)

clens init                 # 1. install hooks into this project
# ... use Claude Code normally ...
clens distill --last       # 2. analyze your latest session
clens web                  # 3. open the dashboard in your browser

That's it. `clens init` wires the capture hooks, your sessions land as local JSONL, and `clens web` launches the full dashboard at `http://127.0.0.1:3700`. Prefer the terminal? `clens explore` opens the interactive TUI instead.

Web Dashboard

`clens web` serves a browser dashboard for everything cLens captures — session list, per-session detail, multi-agent trees, decision and backtrack timelines, edit chains, plan drift, and cross-session insights. The web server is bundled into the CLI binary at build time, so npm consumers need nothing extra to run it.

![Session detail](.github/assets/dashboard-detail.png)

clens web                      # launch on http://127.0.0.1:3700, opens your browser
clens web --port 8080          # custom port
clens web --no-open            # don't auto-open the browser
clens web --global             # aggregate sessions across all your repos

The dashboard is served locally and gated behind a per-launch token printed to your