castle-hud
by Eddy Wong · ★ 0 · updated 8 days ago
A Castlevania-style HUD above the prompt in the Claude Code desktop app. It shows how full the context is (a blood meter), your 5-hour and weekly limits (moons), how long the prompt cache stays warm (a stopwatch), what this session and the 5-hour window cost, how long the session has run, the last turn, lines changed and running subagents (bats). A pixel castle grows bolder as the context...
Install
/plugin marketplace add eddywong888/claude-castle-mod/plugin install castle-hud@claude-castle-modThen run /reload-plugins or start a new session. Requires Claude Code 2.1.287+.
What it hooks into
From an automated scan with claude plugin validate, not a security review. Mods run with your permissions; read the code before installing.
- Events
session.startsession.endclassic.SessionStartclassic.PostModelSwitchsession.compactturn.startsession.measuretool.callcommand.runagent.spawnturn.completeui.render- API calls
$.agent.list$.audio.play$.clock.every$.clock.now$.command.register$.session.authorize$.session.id$.session.surfaces$.session.usage$.state.get$.state.set$.store.delete$.store.get$.store.keys$.store.set$.ui.resolve$.ui.toast- Draws
AbovePrompt- Can see
classic hookscompactionevery tool callBash callssubagent spawns- Reach
- level 1 of 3 reads mod staterequests an Anthropic credential handleplays audiopersists statedraws
Origin
- How it got here
- Automated scan of public GitHub repos, via the CC0 dataset awesome-claude-code-mods (scan of ).
- Repository
- github.com/eddywong888/claude-castle-mod
- Path in repo
- repository root
- Source commit
7aa50c8the exact code the scan read- Author
- Eddy Wong @eddywong888
- License
- A license file GitHub could not identify — read it in the repository before reusing code.
- First published
- Last pushed
- First listed here
Name and description come from the mod's own manifest. We link to the code; we don't host it, and it stays under its author's license.