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.1

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.1
File Size Uploaded Provenance Actions
worklog_for_claude_code-0.3.1.tar.gz 133.9 kB With provenance Details for worklog_for_claude_code-0.3.1.tar.gz

Built distribution (wheel)

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

Total release size: 248.1 kB

Release files / worklog_for_claude_code-0.3.1.tar.gz

Download URL worklog_for_claude_code-0.3.1.tar.gz
Size 133.9 kB
Tags Source
SHA-256 checksum
How to use checksums
5bcf608d327a4f7da1ed1cf8a7e74a77fc9658db592cd96c0947b26904494da9
BLAKE2b-256 checksum
How to use checksums
05964f58316d355f51c2ae3d0bff3b215341f1965e18ff42fcea50bfaebb714a
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 Nov 2, 2026.

Transparency log

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

Download URL worklog_for_claude_code-0.3.1-py3-none-any.whl
Size 114.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8289705a1f473ef21efe5145b8138aebfb92a5d6990490268efc5e8dd16e6ab1
BLAKE2b-256 checksum
How to use checksums
69d85fcd838312fa12fcf87926e81400446b4a20623151094ac02af82bee1a3a
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 Nov 2, 2026.

Transparency log

Security for worklog-for-claude-code 0.3.1

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.1.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 Nov 2, 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