What is mosaic?
mosaic is a Claude Code mod by ersinkoc that kOZMOS Mosaic: a GitHub-style activity calendar across sessions. 26 weeks of days colored by turns, tool calls, tokens or dollars, with the current and longest streak, the best day, totals. It is listed under Cost & usage and has 13 GitHub stars.
| Type | Claude code mod |
|---|---|
| Author | ersinkoc |
| Repository | ersinkoc/claude-mods |
| Popularity | 13 GitHub stars |
| Category | Cost & usage |
| Security | Low risk (100/100) |
| Rank | #399 of 5,272 Claude Code mods; #69 in Cost & usage |
| License | MIT |
| Last commit | 2026-10-18 |
| Hooks | 8 events |
| Sees | every tool call |
| Draws on | Pane |
Is mosaic safe to install?
mosaic scores 100/100 on the MCPMods security check: Low risk. No checks raised a concern. It passed 8 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 |
|---|---|
| No network access | Pass |
| Starts no processes | Pass |
| Writes no files or config | Pass |
| Doesn't read environment variables | Pass |
| Only sees the events it hooks | Pass |
| Doesn't drive Claude | Pass |
| Passes claude plugin validate | Pass |
| Has an open-source license | Pass |
API calls in its code
| Call | What it means |
|---|---|
$.clock.every | |
$.clock.now | |
$.command.register | |
$.session.usage | |
$.state.get | |
$.state.set | |
$.store.get | keeps its own state |
$.store.set | keeps its own state |
$.ui.close | draws interface |
$.ui.open | draws interface |
$.ui.panes | draws interface |
$.ui.resolve | draws interface |
How do I install mosaic?
- 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/ersinkoc/claude-mods claude plugin validate ./claude-mods/mods/mosaic
- Install it. Run this in your terminal, then /reload-plugins in an open session.
claude plugin marketplace add ersinkoc/claude-mods && claude plugin install mosaic@kozmos
Or ask Claude to set it up
Paste this into Claude Code and it installs mosaic for you:
Install the "mosaic" Claude Code mod from https://github.com/ersinkoc/claude-mods/tree/main/mods/mosaic. Run claude plugin validate on it first and show me what it can access before you enable it.
More from ersinkoc/claude-mods
This repository has at least 9 Claude Code mods on MCPMods.
- almanac: KOZMOS Almanac: what this session is made of. Slash commands run, skills invoked, subagent types spawned, MCP servers us (Low risk)
- aurora: KOZMOS Aurora: northern lights above the prompt while the model thinks. Shifting curtains whose intensity and speed foll (Low risk)
- ballast: KOZMOS Ballast: a context coach. A toast when the context window passes warnAt, then a band with an anchor and a water-l (Low risk)
- blackbox: KOZMOS Blackbox: a flight recorder above the prompt. A live Gantt of the current turn: the main loop and each subagent o (Low risk)
- breadcrumbs: KOZMOS Breadcrumbs: the session's web trail in a sidebar. WebSearch queries with result counts and top hits, WebFetch UR (Low risk)
- bridge: KOZMOS Bridge: a mission-control sidebar. Model and effort, context fill, 5-hour and weekly limits with reset countdowns (Review before installing)
- chronicle: KOZMOS Chronicle: the session as a timeline. Prompts, turn ends with duration, tool count and spend, subagents spawned a (Low risk)
- clawdling: KOZMOS Clawdling: a pixel crab companion that lives above the prompt. It blinks and sways, scuttles while tools run, thi (Low risk)