Skip to main content

Worklog for Claude Code

A diary of your Claude Code work, written for you. See what you did each day and how many tokens it used.

Downloads PyPI GitHub stars CI License: MIT

Worklog: today's tokens, sessions and time, a 14-day chart and what you worked on

▶️ Watch the 90-second video

What it does

  • ✅ Writes down what you worked on, project by project, every day. Claude writes the summary.
  • 📊 Shows how many tokens you used, per day, account and model.
  • 👥 Handles several Claude accounts and computers, even if you switch accounts with a one-click app.
  • 🔒 Stays private: everything lives on your computer (and your own private git repo, if you want).
  • 💻 Runs on Linux, macOS and Windows, quietly in the background.

Try it (nothing is installed)

pipx run --spec worklog-for-claude-code claude-worklog demo

Open http://localhost:8766 to see it with made-up data. Press Ctrl+C to stop.

Install in 3 steps

You need Python 3.10+, git and Claude Code. No pipx yet? See the beginner guide.

1. Install

pipx install worklog-for-claude-code

2. Create a folder for your log and start Worklog

git init ~/claude-worklog-data          # Windows PowerShell: git init "$HOME\claude-worklog-data"
claude-worklog install-service

3. Open http://worklog.localhost:8765 (or http://localhost:8765) and fill in the short form.

A checklist then shows anything still missing, with the exact command for your computer. When everything is ticked, it disappears. That's it: use Claude Code as usual.

A closer look

When you worked, the last 5 weeks and today's projects
When you worked, your streak, and where the time went.
Setup checklist
A setup checklist with steps for your system.
New account found
New accounts are noticed for you.
A new version is out: Update now
Updates in one click.

Privacy

  • Only short notes are saved: the first 300 characters of your prompts, token counts, file names and commit messages. Never your files or Claude's replies.
  • Common secrets (API keys, passwords, e-mails) are blanked out before saving. This is best effort, so keep your data repo private.
  • Summaries are written by your own Claude account. Turn them off in Settings to stay fully offline.
  • The only other request: once a day, Worklog asks pypi.org whether a new version is out. Nothing about you is sent, and you can turn it off.

Privacy in detail →

Questions

It says Sonnet, but I use Opus? The "By model" list shows what Claude Code really used. To get better summaries, pick Opus in Settings → Summaries.

Several accounts or computers? Settings walks you through it. For several computers, see Full setup.

How do I update? Click Update now when the dashboard says a new version is out, or run pipx upgrade worklog-for-claude-code.

Something isn't working? Run claude-worklog doctor, or see Troubleshooting.

How do I remove it? claude-worklog uninstall-service, then pipx uninstall worklog-for-claude-code. Your log stays.

Like it? ⭐

If Worklog saves you time, please star it on GitHub. It helps others find it.

📘 Beginner guide · 📖 Full guide · 🐛 Report a bug · 📝 Changelog


MIT © 2026 Urvin · Not affiliated with or endorsed by Anthropic.

Metadata

Release files for worklog-for-claude-code 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for worklog-for-claude-code 0.3.0
File Size Uploaded Provenance Actions
worklog_for_claude_code-0.3.0.tar.gz 123.1 kB With provenance Details for worklog_for_claude_code-0.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for worklog-for-claude-code 0.3.0
File Interpreter ABI Platform Actions
worklog_for_claude_code-0.3.0-py3-none-any.whl Python 3 none any Details for worklog_for_claude_code-0.3.0-py3-none-any.whl

Total release size: 228.5 kB

Release files / worklog_for_claude_code-0.3.0.tar.gz

Download URL worklog_for_claude_code-0.3.0.tar.gz
Size 123.1 kB
Tags Source
SHA-256 checksum
How to use checksums
754f47c825b489b6b78c0fd0f98e3a87b8f2d8779922d03d65210421edb97b8b
BLAKE2b-256 checksum
How to use checksums
a19e36e39e95ca997e9dffeb1d6f1bfeee66f065658265c1af427d3abf1b1c57
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Release files / worklog_for_claude_code-0.3.0-py3-none-any.whl

Download URL worklog_for_claude_code-0.3.0-py3-none-any.whl
Size 105.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b740a832f8b8c6022d4724c44f0464cc7b315fc32c386f9d9f8eab0f5d5081a5
BLAKE2b-256 checksum
How to use checksums
c2dc98f2e3fb79187ccca96826a74f7f752f2d7f4da26466343d92f13ebf484d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Security for worklog-for-claude-code 0.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for worklog_for_claude_code-0.3.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page