convez.ai
SkillProdutividadeIniciante
jeecgboot

Session Timer para Claude Code

jeecgboot/claude-code-session-timer-hook

Cronômetro automático: tempo por turno + total acumulado em cada resposta

Ver no GitHub
InicialPluginScore · de 0 a 100

Hook que mede e reporta automaticamente o tempo decorrido por turno e acumulado em cada resposta do Claude Code. Instala-se globalmente em ~/.claude/ para funcionar em todos os projetos sem configuração individual.

Instalação

$npx convez-ai jeecgboot/claude-code-session-timer-hook

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
3
Forks
1
Acompanhando
0
Saúde
37%
Último commit
há 6 meses
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Monitorar tempo gasto em sessões de desenvolvimento com Claude Code
  • Rastrear produtividade e duração de tarefas de codificação
  • Identificar gargalos e sessões longas demais de forma visual

Veredito

Ferramenta leve e prática para quem quer visibilidade imediata do tempo investido em sessões de Code. Instalação global e sem ruído visual — apenas exibe um sumário compacto a cada turno.

README

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

Session Timer

English · 简体中文

A stopwatch for Claude Code — per-turn + cumulative elapsed time, auto-reported

At the end of every Claude turn you'll see the time spent on this round and the running total:

⏱ Turn 4.72s · Total 1m18s

Project: https://github.com/jeecgboot/claude-code-session-timer-hook

Global Install (paste this paragraph into Claude Code)

Installs into ~/.claude/ so the timer is enabled globally for every project — no per-project setup.

Copy the block below verbatim and send it to Claude Code — it will download the script and merge the config for you:

Please install session_timer from https://github.com/jeecgboot/claude-code-session-timer-hook **globally** (under ~/.claude/, NOT into the current project's .claude/). Steps:

1. Download session_timer.py to ~/.claude/hooks/ (create the directory if it doesn't exist). URL:
   https://raw.githubusercontent.com/jeecgboot/claude-code-session-timer-hook/main/session_timer.py
2. Merge the following 4 hooks into the `hooks` field of the **global** ~/.claude/settings.json (keep my existing config — do not overwrite):
   - SessionStart     → python "$HOME/.claude/hooks/session_timer.py" session_start 2>/dev/null || true
   - UserPromptSubmit → python "$HOME/.claude/hooks/session_timer.py" start         2>/dev/null || true
   - Stop             → python "$HOME/.claude/hooks/session_timer.py" stop          2>/dev/null || true
   - SessionEnd       → python "$HOME/.claude/hooks/session_timer.py" end           2>/dev/null || true
   Each hook's type is "command".
3. Validate that settings.json is valid JSON, then tell me to run /hooks to activate.

Once installed, run /hooks to reload the config — the stopwatch will show up on the next turn.

Requirement: Python 3 on PATH (the python command must work). macOS / Linux / Windows (git bash) all supported.

Usage

  • Automatic display — nothing else to do; each Claude reply ends with the timer line.
  • Reset the cumulative total — tell Claude "reset cumulative time", or run python ~/.claude/hooks/session_timer.py reset --all in your terminal.

License

Licensed under the Apache License 2.0.

Uninstall

Please uninstall session_timer: delete ~/.claude/hooks/session_timer.py and the ~/.claude/session_timing/ directory, and remove these 4 hooks from ~/.claude/settings.json (SessionStart / UserPromptSubmit / Stop / SessionEnd — keep entries from my other projects).
Ver o original no GitHub

Bom para

Relacionados