claudeers.
// Claude Plugins

worklog

A Claude Code mod to track automatically the time and tokens of each project

// Claude Plugins[ cli ][ api ][ desktop ][ web ][ mobile ][ claude ]#claude#plugins◷ MIT$open-sourceupdated 3 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up worklog (claude-plugin project) into my current project.
Found on https://claudeers.com/worklog
Repo: https://github.com/Abdoul-sudo/worklog
Homepage/docs: —
Detected install method: claude-plugin → /plugin install worklog@Abdoul-sudo/worklog
Category: plugins. Platforms: cli, api, desktop, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)

⚠ Unverified / not recently updated — review before pasting a run-this config.

/plugin marketplace add Abdoul-sudo/worklog
/plugin install worklog@Abdoul-sudo/worklog
// or clone
git clone https://github.com/Abdoul-sudo/worklog

// compatibility

Platformscli, api, desktop, web, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Worklog

Time, tokens and API price for each project, counted for you while you work with Claude.

Worklog above the Claude Code prompt box: the time, the tokens and the streak, a heatmap of the year, and the time of each name. The pointer clicks Day, Month and All. In the settings, it picks the Sakura theme and sets Show to Tokens and price, then clicks Day, Month and All again: the API price takes the place of the time. Then it goes back to the Aurora theme and to Time and tokens.

Quick start · How the timer works · Tokens and price · Breaks · Project names · Themes · Terminal · Settings · FAQ


You work with Claude on several projects, sometimes for hours without a break. Where did the time go? Which project used the most tokens? How much would they cost on the API?

With Worklog, you can see the time, the tokens and the API price of each project, right above the prompt. Worklog counts everything automatically for you: you do not start, stop or pause anything.

Quick start

claude plugin marketplace add Abdoul-sudo/worklog
claude plugin install worklog@worklog

Restart Claude Code, then work as usual. A chip at the bottom shows the name of the session and its time today, for example ⏱ mobile-app · 1h 12. Click the chip to open Worklog, or type /worklog.

Worklog needs Claude Code 2.1.325 or later. Node.js is optional: Worklog uses it once, to read your past history.

How the timer works

  • The timer starts with your first message in a session. Opening a session does not count.
  • The timer runs while Claude works: answers, subagents, workflows, Ultracode and background commands, even when they work alone for hours.
  • When Claude is done, a break starts. When you come back, Worklog decides if the break counts as work.
  • In one project: if several things work at the same time, the time counts only once. For example, if 3 subagents work for 10 minutes, the project gets 10 minutes, not 30.
  • Across projects: if two projects work at the same time, each project gets its time, and the total adds them up. For example, if projects A and B both work for 1 hour at the same time, each gets 1 hour and the total is 2 hours. Worklog then shows "incl. 1h 00 in parallel", so you can still see the real time.

Tokens and price

Do you look at your tokens more than at your time? Set Show to Tokens and price in the settings. The API price then takes the place of the time: in the stats, in each line and in the heatmap.

Worklog with Show set to Tokens and price: 21.5M tokens and $23 today, and the tokens and the price of each name.

  • The price is what your tokens cost at the Anthropic API list prices, for each model and each answer.
  • Worklog always counts the price, also when it shows the time. So when you switch, your past days have their price too.
  • With a Pro or Max plan, the API price is not your bill. It shows what your work would cost on the API.

Breaks

A break is the time between the end of Claude's work and your next message. A short break counts as work. For a long break, Worklog asks you. A very long break does not count.

One day with Worklog. Work always counts. A short 30 min break counts as work when you come back. For a long 2h break, Worklog asks you. The night is a very long break: it does not count.

Example. Claude finishes at 10:00. You stop for a coffee. At 10:30, you send a new message. Worklog adds the 30 minutes at that moment. During the break, the total does not change. It catches up when you come back.

BreakWhat Worklog does
Short: up to 1hCounts the break as work.
Long: from 1h to 4hAsks you if the break was work.
Very long: more than 4hDoes not count the break as work, and does not ask.

If you close Claude Code during a short break, the break counts as work up to the moment you close Claude Code.

When Worklog asks, click Count to add the break, or Ignore to leave it out.

Under Worklog, the question: 2h 08 break on website, from 9:12 to 11:20. Count it as work? Two buttons: Count and Ignore.

You can change the 1h and the 4h in the settings. To never get the question, set Then ask to Never.

Project names

The time of each session goes to one name, such as a project or a task. Worklog decides on the name in this order:

  1. The name that you choose, with /worklog <name> or in the list.
  2. An ID in your messages, such as PROJ-142.
  3. An ID in the name of your Git branch, such as feature/PROJ-142-login.
  4. The name of the project folder. In a Git worktree, the name of the main project.

When Worklog finds the first ID of a session, the time before it also goes to this ID.

To count this session for another name from now on, point to the name in the list, then click ⇄.

The list of names. The pointer is on the switch icon next to website.

Themes

Worklog has eight themes in the desktop app. Click the gear, then click a theme.

Worklog in its eight themes: Default, Night, Aurora, Ember, Forest, Ocean, Dusk and Sakura.

In the terminal

Worklog works in the terminal too, with the same data. In a wide terminal, the heatmap shows one square for each day.

Worklog in the terminal: the stats and the names on the left, the heatmap of the year on the right.

To click in Worklog in the terminal, use the fullscreen mode: /tui fullscreen.

Usage

TaskAction
See another periodClick Day, Week, Month, Year or All. Click ‹ or › to go back or forward.
Count this session for another name, from now onPoint to the name, then click ⇄. In the terminal, click the name.
Count this session for a new name, from now onClick + Add item, type the name, then press Enter.
RenameClick ✎ next to the name. The new name also replaces the old one on past days.
Open the settingsClick the gear. In the terminal, click ≡.
CommandWhat it does
/worklogShows or hides Worklog.
/worklog <name>Counts this session for <name>, from now on. For example: /worklog PROJ-142.

Settings

The settings, with the Show menu open: Time and tokens, or Tokens and price. The eight themes on the right.

SettingDefaultWhat it does
Show the activity heatmapOnShows one square for each day of the year.
ShowTime and tokensShows the time and the tokens, or the tokens and their API price.
LanguageEnglishEnglish or French.
Stay active during breaksUp to 1hA break up to this length is short: it counts as work.
Then askUp to 4hFor a long break, up to this length, Worklog asks you if it was work. A very long break does not count. Never turns off the question.
ThemeNightDefault, Night, Aurora, Ember, Forest, Ocean, Dusk or Sakura. Desktop app only.

Update

claude plugin marketplace update worklog
claude plugin update worklog@worklog

Then restart Claude Code, or type /reload-plugins.

Uninstall

claude plugin uninstall worklog@worklog

Your data stays in ~/.claude/worklog/. To remove it, delete this folder.

FAQ

Does the timer stop when I leave?

Yes. The timer runs only while Claude works. When you come back, Worklog decides if your break counts as work.

I take a 30-minute break, then I send a message. Does the total grow by 30 minutes?

Yes, with the default settings. Worklog adds the 30 minutes when you send the message. During the break, the total does not move.

Do subagents, Ultracode and background commands count?

Yes. The timer runs while they work, even when you do not type. Their tokens count too.

While Claude waits for a background command to end, the time counts as work. If you come back before it ends, such as with a dev server that never stops, the wait is a break.

Does Worklog see my past work?

Yes, if Node.js is installed. On the first start, Worklog reads your Claude Code history. Without Node.js, Worklog counts from the day you install it.

Where does the API price come from?

Worklog takes the prices from the public LiteLLM price list. It gets the list again once a day.

For your past work, Worklog reads the details of each answer in your Claude Code history. If Claude Code deleted an old conversation, the tokens of that conversation have no price.

Do all tokens have the same price?

No. The API gives a different price to each type of token, and Worklog uses each price:

  • Input tokens (what Claude reads): the normal price.
  • Output tokens (what Claude writes): about 5 times the input price.
  • Cache writes (Claude saves your conversation for later): 1.25 times the input price for 5 minutes, 2 times for 1 hour.
  • Cache reads (Claude reads the saved conversation again): only 0.1 times the input price.

In long sessions, most tokens are cache reads. They are cheap, so many tokens can still cost little.

Does a resumed or forked conversation count twice?

No. When you resume or fork a conversation, Claude Code can copy old messages into the new file. Worklog counts each message only once.

What does Worklog not count?

Work outside Claude Code: meetings, calls and other tools.

Privacy

Worklog keeps its data on your computer, in ~/.claude/worklog/. It does not keep your messages. It sends no data about you or your work over the network.

Once a day, Worklog downloads the public LiteLLM price list to count the API price. To stop this download, set the environment variable WORKLOG_PRICES to off.

To keep the data in another folder, set the environment variable WORKLOG_DATA_DIR.

License

MIT

// faq

What is worklog?

A Claude Code mod to track automatically the time and tokens of each project. It is open-source on GitHub.

Is worklog free to use?

worklog is open-source under the MIT license, so it is free to use.

What category does worklog belong to?

worklog is listed under plugins in the Claudeers registry of Claude-compatible tools.

4 views
★ 12 stars
unclaimed
updated 3 days ago

// embed badge

worklog on Claudeers
[![Claudeers](https://claudeers.com/api/badge/worklog.svg)](https://claudeers.com/worklog)

// retro hit counter

worklog hit counter
[![Hits](https://claudeers.com/api/counter/worklog.svg)](https://claudeers.com/worklog)

// reviews

// guestbook

0/500

// related in Claude Plugins

🔓

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

// pluginsmultica-ai/★ 230,631[ claude ]
🔓

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…

// pluginsanthropics/⟨Python⟩★ 156,472[ claude ]
🔓

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

// pluginsHKUDS/⟨Python⟩★ 58,467◷ Apache-2.0[ claude ]
🔓

financial-services — a Claude ecosystem project on GitHub.

// pluginsanthropics/⟨Python⟩★ 41,409◷ Apache-2.0[ claude ]
→ see how worklog connects across the ecosystem