convez.ai
SkillProdutividadeIntermediário
veryCoolTimo

Worklog — Skill de Timesheet em Tempo Real

veryCoolTimo/claude-worklog-skill

Registre timesheets automaticamente enquanto trabalha em projetos.

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude Code que registra automaticamente seu trabalho em uma Google Sheet conforme você trabalha, com resumo do dia, estimativa de horas e nome do projeto. Elimina a necessidade de reconstruir timesheets manualmente ao final do mês, integrando-se naturalmente ao fluxo de desenvolvimento via hooks e comandos CLI.

Instalação

$npx convez-ai veryCoolTimo/claude-worklog-skill

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
14%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Rastrear horas de trabalho por projeto sem reconstruir ao final do mês
  • Gerar relatórios de timesheet formatados com totais por mês
  • Integrar logging de trabalho automaticamente em sessões Claude Code

Veredito

Solução bem arquitetada que resolve um problema real de DevOps/produtividade: timesheet semi-automático via IA sem depender de entrada manual. Requer setup inicial (Google Cloud service account) mas oferece fluxo robusto com fallback offline e CLI testada.

README

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

worklog — Claude Code skill for real-time timesheets

A Claude Code skill that logs your work to a Google Sheet as you work — one row per day per project, with a concise summary of what you did, an effort estimate in hours, the date, and the project name. No more reconstructing a timesheet from git history at the end of the month.

How it works

Claude in a work project
  ├─ SessionStart hook  ──▶ nudge + today's date (only in tracked projects)
  ├─ Skill `worklog` (brain): resolve project, summarize work, estimate hours, confirm row
  └─ worklog CLI (engine, Python + gspread)
       • upsert by (date, project): exists → hours += , text appended; else → new row
       • regenerates the whole formatted sheet: MONTH YEAR headers, per-month totals,
         GRAND TOTAL — data rows are the single source of truth
       └─ service account ▼
   Google Sheet: one formatted timesheet (month blocks + totals), exactly like the manual one
  • Hours are Claude's effort estimate by volume of work (rounded to 0.5), not wall-clock.
  • Semi-automatic: Claude logs at natural breakpoints, plus a manual /worklog command.
  • Per-project opt-in: run worklog init "<Project>" in a repo to start tracking it.
  • Auth: a Google Cloud service account; the sheet is shared with its email.

Engine commands

CommandPurpose
worklog init "<Project>"Onboard the current repo (marker + instruction in CLAUDE.md)
worklog add --project "<P>" --hours <n> --text "<...>"Upsert a day's entry
worklog show [--date DD.MM.YYYY]Show entries for a day
worklog projectsList tracked projects
worklog flushResend entries buffered while offline

All commands support --dry-run.

Status

Engine, skill, and hook implemented and unit-tested (pytest — 28 tests). Pending: the one-time Google Cloud setup (service account + shared sheet).

Setup

See docs/SETUP.md — Google Cloud service account, sheet template (Log + Report), ./install.sh, and SessionStart hook registration.

Development

python3 -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"
pytest -q
Ver o original no GitHub

Bom para

Relacionados