Claude Code mod

xray

xray's Claude Code host: two glanceable cards under the spinner, what Claude is doing and its to-do list, plus a session genome (every step, one colored cell). The same core also runs in omp, pi, Hermes, Grok Build and dsh-tui.

1 starsSpinner, theme & fun modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/freakinfrick/xray.git
claude --plugin-dir ./xray/.

The repo has no marketplace file, so load the plugin folder directly with --plugin-dir.

What it can access

Reach
L2Writes or runs: runs processes, drives Claude, reads files, reads env vars, reads mod state, persists state, draws, other: $.device.class
Sees
classic hooks, every prompt, subagent spawns, every tool call
Draws in
SpinnerPaneAbovePrompt
Hooks
session.startcommand.runprompt.attachmentprompt.composeclassic.SessionStartclassic.UserPromptSubmitprompt.submitsession.appendagent.spawntool.callturn.stepturn.completesession.endui.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.
Claude Code docs

Details

Repository
freakinfrick/xray
Folder
.
Author
freakinfrick
Type
Spinner, theme & fun mods
Last updated
6 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is xray?

xray's Claude Code host: two glanceable cards under the spinner, what Claude is doing and its to-do list, plus a session genome (every step, one colored cell). The same core also runs in omp, pi, Hermes, Grok Build and dsh-tui. It is a mod for Claude Code, from freakinfrick/xray on GitHub.

What can the xray mod access?

Its widest reach is "writes or runs" (runs processes, drives Claude, reads files, reads env vars, reads mod state, persists state, draws, other: $.device.class). It sees classic hooks, every prompt, subagent spawns, every tool call. It draws in Spinner, Pane, AbovePrompt. Like any mod, it runs with your permissions.

How do I install xray?

Clone freakinfrick/xray and start Claude Code with --plugin-dir pointing at the mod's folder (.).

Is xray popular?

freakinfrick/xray has 1 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 6 October 2026.

More spinner, theme & fun mods

vibe-gambit

1

PopFlamingo/vibe-gambit

Play chess on Lichess while Claude Code works: the board in a pane, live games against a random opponent, a friend or Stockfish hosted on Lichess.

Spinner, theme & fun mods/plugin install

claude-games

4

mohi-devhub/claude-games

Arcade games above the Claude Code prompt (a dodge race, Breakout, a dino runner and a side-scrolling shooter) that pause when Claude finishes a turn and react to the edits, tests and commits Claude makes. Needs function hooks (early access) and an interactive terminal.

Spinner, theme & fun mods

under-management

1

Interesting-Systems/under-management-claude

Play Under Management while Claude works on a long turn. After 20 s of work, press 1: the game opens in a 960 x 600 window of its own and pauses itself when Claude finishes.

Spinner, theme & fun mods/plugin install

apercu

tibzejoker/claude-mods

What Claude is building (website, mobile app, desktop client, Unity game…), live in a panel of the client (desktop, mobile in Remote Control, terminal): Claude hooks up the project and the network bridge itself, and drives the same target as you

Spinner, theme & fun mods/plugin install

twenty-forty-wait

1

leonidb/claude-code-mods

A 2048 game above the prompt to keep your attention in Claude Code while it works, with a live view of Claude's work and a your-turn card when it stops.

Spinner, theme & fun mods/plugin install

arcade

thefotes/pane-arcade

Play Snake, Minesweeper, 2048, chess (vs Stockfish) and CHIP-8 ROMs in a pane while Claude works.

Spinner, theme & fun mods/plugin install

Browse the most popular Claude Code mods, all spinner, theme & fun mods, or the skills and MCP server directories.