Claude Code mod
castle-hud
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 fills and catches fire as the prompt cache runs down. You earn XP, levels, daily streaks and 14 achievements as you work; type /castle to see them. Everything stays on your machine.
Install
/plugin marketplace add eddywong888/claude-castle-mod
/plugin install castle-hud@claude-castle-modMods install like plugins. Run /reload-plugins or start a new session to load it.
What it can access
- Reach
- L1Reads: reads mod state, requests an Anthropic credential handle, plays audio, persists state, draws
- Sees
- classic hooks, compaction, every tool call, Bash calls, subagent spawns
- Draws in
AbovePrompt- Hooks
session.startsession.endclassic.SessionStartclassic.PostModelSwitchsession.compactturn.startsession.measuretool.callcommand.runagent.spawnturn.completeui.render
From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.
How Claude Code mods work
- A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
- It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
- Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
- Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Details
- Repository
- eddywong888/claude-castle-mod
- Folder
.- Marketplace
claude-castle-mod- Author
- Eddy Wong
- License
- NOASSERTION
- Last updated
- 11 October 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is castle-hud?
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 fills and catches fire as the prompt cache runs down. You earn XP, levels, daily streaks and 14 achievements as you work; type /castle to see them. Everything stays on your machine. It is a mod for Claude Code, from eddywong888/claude-castle-mod on GitHub.
What can the castle-hud mod access?
Its widest reach is "reads" (reads mod state, requests an Anthropic credential handle, plays audio, persists state, draws). It sees classic hooks, compaction, every tool call, Bash calls, subagent spawns. It draws in AbovePrompt. Like any mod, it runs with your permissions.
How do I install castle-hud?
Inside Claude Code (v2.1.287 or later), run /plugin marketplace add eddywong888/claude-castle-mod and then /plugin install castle-hud@claude-castle-mod.
More context & usage mods
cash-tax
kevinfactor/claude-kit
Warns before an idle session's prompt cache expires and the next message re-reads the whole conversation at full price, with the token count and cost. /keepwarm pings the cache to keep it alive.
cc-context-bar
rendi-febrian/rendifebrian-mods
Context bar for Claude Code: context length, tokens in/out and estimated cost, drawn in the band above the prompt.
campfire-hud
aryswisnu/campfire-hud
A live HUD for Claude Code: context, spend, usage limits and repo status in RPG gauges, and your subagents as a fantasy party around a campfire.
cc-dock
New-Retr0/claude-dock
A dock above the prompt: plan usage windows, main and subagent context fill, and the shells running now with what each one is doing.
cachekeeper
the-cybersapien/claude-cache
Compacts an idle Claude Code session while its prompt cache is warm, with an AFK mode, a handoff note, and a cache TTL countdown in the status line and above the prompt.
cc-hud
kimyong6366/cc-hud
A usage panel under the prompt (model, project, context, 5-hour and weekly quota with pace warnings) with a settings toolbar, English/Chinese UI and one-click handoff prompts with a handoff history and clear & continue; a subagent board showing what each subagent and workflow agent is doing; plus a moody pixel crab above the prompt that acts out each tool and walks with your subagents (terminal; Windows / macOS / Linux)
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.