convez.ai
Agente
alofigh648

vibe-kline

alofigh648/vibe-kline

Ver no GitHub
InicialPluginScore · de 0 a 100

Turn Claude Code edits into real-time K-line candlestick charts. Every file edit is a candle.

Instalação

$npx convez-ai alofigh648/vibe-kline

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

vibe-kline

Real-time K-line candlestick charts for your Claude Code sessions.
Every file edit becomes a candle. Watch your coding session unfold like a trading chart.

中文文档


What it does

vibe-kline hooks into Claude Code and records each file edit as a candlestick:

  • Open / Close — total project line count before and after the edit
  • Delta — lines added (green) or removed (red)
  • Session bands — alternating tints per conversation
  • Commit markers — gold ◆ on git commits, hover for message and hash
  • Activity heatmap — 14-day edit intensity grid by hour of day

The chart polls for new data automatically — keep it open in a tab while you code.

Requirements

  • Python 3.9+
  • Claude Code
  • Git (recommended; falls back to cwd without it)

Install

Clone vibe-kline anywhere on your machine — it does not need to live inside your project:

git clone https://github.com/alofigh648/vibe-kline.git ~/tools/vibe-kline
cd ~/tools/vibe-kline
./install.sh

Choose between two modes:

Global — all projects (recommended)

./install.sh --global

Hooks are installed to ~/.claude/hooks/ and run for every Claude Code session on your machine. kline.html is auto-copied into each project on your first edit, or immediately with:

./install.sh --init /path/to/my-project

Project — single project only

./install.sh --project /path/to/my-project

Hooks and kline.html go into the specified project directory. No path? Defaults to the current directory:

cd /path/to/my-project
./install.sh --project

Usage

1. Start the server from your project directory (once per session):

cd /path/to/my-project
python -m http.server 38080

2. Open the chart:

http://localhost:38080/kline.html

Start coding with Claude Code — candles appear in real time.

Chart features

FeatureDescription
K-line candlesColor = file type · Brightness = delta magnitude
MA lineAdaptive moving average · click legend to toggle
Bollinger BandsClick the BB带 button
Session bandsEach Claude Code conversation gets its own color band
Commit markers◆ at git commits · hover for hash and message
Time gap badgesAmber badge when >30 min gap between edits
Activity heatmap14-day grid (hour × day) in the sidebar
Replay▶ button to replay the entire session
File focusClick a file in the leaderboard to highlight its candles
ExportSave the current view as PNG

Keyboard shortcuts

KeyAction
← →Navigate candles
+ / -Zoom in / out
SpaceJump to latest
HomeJump to first candle
EscCancel file focus

Data files

FileDescription
.claude/kline_data.jsonFull internal data (keep private)
kline_data.jsonPublic export polled by the chart
kline.htmlSelf-contained chart viewer

Suggested .gitignore additions:

kline.html
kline_data.json
.claude/kline_data.json

Or commit kline.html to share a session snapshot with your team.

How it works

Claude Code edit
    │
    ├── PreToolUse hook  → snapshot line count  (candle open)
    │
    └── PostToolUse hook → count again (close) → append candle → patch kline.html
                                ↑
                       kline_utils.py resolves project root via git or cwd

Data is patched directly into kline.html between marker comments — no database, no build step.

Uninstall

Global:

rm ~/.claude/hooks/pre_tool_use.py \
   ~/.claude/hooks/post_tool_use.py \
   ~/.claude/hooks/kline_utils.py

Project:

rm .claude/hooks/pre_tool_use.py \
   .claude/hooks/post_tool_use.py \
   .claude/hooks/kline_utils.py

License

MIT

Ver o original no GitHub

Bom para

Relacionados