What is usage-log?
usage-log is a Claude Code mod by MahadSalim that logs plan readings, context fill, engine cost, turn outcomes, tool timing, permission asks, commands and settings hook runs per session. Records what each session loads into its context. It is listed under Cost & usage and has no public popularity data yet.
| Type | Claude code mod |
|---|---|
| Author | MahadSalim |
| Repository | MahadSalim/claude-mods |
| Popularity | no public popularity data yet |
| Category | Cost & usage |
| Security | High risk (44/100) |
| Rank | #3,898 of 5,272 Claude Code mods; #732 in Cost & usage |
| Last commit | 2026-10-17 |
| Hooks | 14 events |
| Sees | classic hooks, compaction, every skill, every tool call |
| Draws on | nothing |
Is usage-log safe to install?
usage-log scores 44/100 on the MCPMods security check: High risk. Things to review: sends data over the network; starts processes outside the sandbox; writes files or config; reads environment variables. It passed 2 of 8 checks.
Mod footprints come from claude plugin validate, which lists every event a mod hooks and every API call it makes without running it.
| Check | Result |
|---|---|
| Sends data over the network | Review |
| Starts processes outside the sandbox | Review |
| Writes files or config | Review |
| Reads environment variables | Review |
| Only sees the events it hooks | Pass |
| Doesn't drive Claude | Pass |
| Validator reported problems | Note |
| No license detected | Note |
API calls in its code
| Call | What it means |
|---|---|
$.clock.now | |
$.command.register | |
$.env.get | reads env vars |
$.fs.read | reads files |
$.fs.stat | reads files |
$.fs.write | writes files |
$.http.fetch | network requests |
$.process.run | runs processes |
$.session.id | |
$.session.model | |
$.session.usage | |
$.session.version | |
$.store.get | keeps its own state |
$.store.set | keeps its own state |
$.ui.invalidate | draws interface |
How do I install usage-log?
- Check your Claude Code version. Mods need Claude Code 2.1.287 or later and are on by default.
claude --version
- Read its footprint. This lists every event it hooks and every API call it makes, without running it.
git clone https://github.com/MahadSalim/claude-mods claude plugin validate ./claude-mods/usage-log
- Install it. Run this in your terminal, then /reload-plugins in an open session.
claude plugin marketplace add MahadSalim/claude-mods && claude plugin install usage-log@claude-mods
Or ask Claude to set it up
Paste this into Claude Code and it installs usage-log for you:
Install the "usage-log" Claude Code mod from https://github.com/MahadSalim/claude-mods/tree/main/usage-log. Run claude plugin validate on it first and show me what it can access before you enable it.
More from MahadSalim/claude-mods
This repository has 7 Claude Code mods on MCPMods.
- agent-delegation: The delegation mode, subagent cap and model routing. (Low risk)
- context-bar: A bar above the prompt that fills as the context window fills. (Low risk)
- live-voice-mode: Voice mode, tap to talk or hands-free: local Whisper transcribes you, Kokoro reads replies. (Review before installing)
- prompt-tools: Rewrites a typed prompt with Haiku and appends saved text to it. (Review before installing)
- turn-rules: Sends questions through AskUserQuestion and keeps a turn going while the task list has open tasks. (Review before installing)
- ui-mod: A band button and a pane that draw and change the settings of every other mod. (Low risk)