Skip to content

About

Ten Claude Code mods: an animated pixel pet, Code Wrapped, lo-fi beats, plus a safety net, changes pane, /standup journal and more.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

28 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

claude-mods

Eleven mods for Claude Code. Install the ones you want; each is independent.

pixel-pet in action: sleeping, waking, narrating, hatching helpers

▶ Watch the 50-second tour with sound · What's new in 0.3

Repo Radar

Repo Radar: a live map of where Claude is working

repo-radar draws your repo as a live map of rectangles, one per folder. Reads glow cyan, edits amber, failures red, and each subagent gets its own colour, so you can watch parallel agents work across your codebase. Glows fade like a radar trace; files touched this session keep a faint tint. /radar opens it. More →

/plugin marketplace add lakmadev/claude-mods
/plugin install repo-radar@claude-mods

For fun

pixel-pet: the pet in its world, its status line, helpers and the context meter

Mod What it does
pixel-pet A tiny animated pixel pet above your prompt. It sleeps (snoring) when things are quiet and wakes slowly when you type. It narrates what Claude is doing without becoming noise (a line when the kind of work changes, one quiet summary in long turns), cheers when tests pass and winces when they fail, and waves at you when Claude needs your OK or a long turn is done. It hatches half-size helpers for each subagent, which slide into the meter line one by one and wave bye when done. It stands in a little pixel world that scrolls while Claude works and changes through your day (meadow, desert, sunset, city skyline, moon), it watches you type, you click it to pet it, it dresses up for Halloween and Christmas, and /pet card saves a picture of it to share. One pet everywhere: the same name and stats in every session. A gradient context meter with your 5-hour and weekly usage sits beside it, details on hover. 28 colours via /pet color <name>.
code-wrapped /wrapped opens your Claude Code Wrapped: a GitHub-style activity heatmap, hours, lines, streaks, top files and tools, your coding personality (Night Owl 🦉, Refactorer 🧹, Shell Wizard 🧙…) and 14 unlockable achievements that pop as toasts. Copy share text puts a one-line brag on your clipboard.
lofi-mode Soft lo-fi beats start when Claude has been working for a few seconds and stop when it finishes. The loop is original and synthesized for this mod. /lofi toggles it. macOS audio.

For work

Mod What it does
context-meter A plain status line: ctx 62% · 5h 85% resets 1h52m · week 40% on a Claude plan (the reset shows once a window passes 70%), or ctx 62% · $1.84 billed (API) when you pay per token. Toasts when context passes 80% or a plan window passes 90%.
safety-net Refuses catastrophic commands (rm -rf ~, mkfs, dd of=/dev/disk, fork bombs). Asks before risky ones (force-push, reset --hard, curl | sh, DROP TABLE, terraform destroy, sudo, …) and before edits to .env, keys, ~/.ssh, .git/ or shell rc files.
changes-pane Side pane listing every file Claude changed this session with +/- line counts. /changes opens it.
done-notifier Chime, toast and desktop notification when a turn longer than 30s finishes or Claude is waiting for you.
prompt-booster Short prompts ("fix it") get your branch, changed files and recent commits as hidden context. Adds /fix-tests, /explain-code, /review-changes, /write-tests, /commit-msg.
session-journal Logs each turn (project, prompt, files touched) across sessions. /journal [days] lists it; /standup [days] writes a Done / In progress / Blockers update.
secrets-redactor Replaces API keys, tokens, private keys and connection-string passwords with [REDACTED:kind] in your prompts and in tool output before the model sees them, and blocks writing a placeholder back over a real secret.

Install

Requires Claude Code 2.1.293 or later: mods are an early-access feature and gain events with each release. Check with claude --version; update with claude update.

In a Claude Code terminal session:

/plugin marketplace add lakmadev/claude-mods
/plugin install pixel-pet@claude-mods

The first line adds this repo as a plugin marketplace (once); the second installs a mod from it. Repeat the second line with any other mod name from the table.

Settings

Each mod's options show in /config once it is installed:

  • context-meter: contextWarnPercent (80), rateLimitWarnPercent (90)
  • safety-net: strict (off). Turns every "ask" into a refusal. Turn it on if you run in auto or bypass-permissions mode, where an ask can be approved without you.
  • changes-pane: autoOpen (on). The pane opens on its own only in terminals 144+ columns wide.
  • done-notifier: minSeconds (30), sound (on), desktop (on)
  • prompt-booster: autoContext (on), maxWords (15)
  • session-journal: retentionDays (30), model (haiku)
  • secrets-redactor: aggressive (off). Also redacts quoted password = "…"-style assignments.
  • pixel-pet: name (Bit), color (teal)
  • lofi-mode: volume (0.35), delaySeconds (4)

Limits

  • safety-net matches patterns. It is not a sandbox: obfuscated commands (eval, base64, aliases) get through.
  • secrets-redactor only catches known token shapes. Once a secret is redacted, Claude can't use it: put real values in files yourself.
  • pixel-pet, code-wrapped and session-journal keep their data in Claude Code's plugin store on your machine. Two sessions finishing a turn at the same instant can drop one update.
  • done-notifier plays its chime on macOS only. Desktop notifications use osascript (macOS) or notify-send (Linux).
  • session-journal keeps your prompts locally, in Claude Code's plugin store on your machine. /standup sends the log to the model you configure.

Develop

Each mod lives in plugins/<name>/: hooks/register.ts(x) is the code and tests/ holds its tests.

claude plugin validate plugins/<name>
claude plugin test plugins/<name>
claude --plugin-dir plugins/<name>

License

MIT, see LICENSE.

About

Ten Claude Code mods: an animated pixel pet, Code Wrapped, lo-fi beats, plus a safety net, changes pane, /standup journal and more.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages