code-modernization

Reviewed at commit c8874f5

Anthropic's guided modernization for legacy codebases, with an optional live progress pane beside the transcript built as a mod.

Made by
Anthropic
What we checked

Sends usage counts, whole numbers only and never code, names or prompts, through Claude Code's own telemetry; you can turn that off. Writes its analysis and sign-off files into your project. The optional pane watches what Claude does but never blocks it.

Review details

Reviewed by the modsforClaude.com maintainers at the pinned commit. Classic hooks run a shell script and optional Python that read only the plugin's own files and print whole-number usage counts for Claude Code's telemetry, plus one environment ping per plugin version and machine at session start; all of it can be turned off. The opt-in pane watches tool calls without blocking them and adds read-only analysis notes to the model's context. No network calls of its own; it writes review and sign-off files under analysis/ and a small state file in the plugin's data folder.

What it uses
  • Reads your prompts: no
  • Sees tool calls: no
  • Blocks or changes tool calls: no
  • Reads or writes files: no
  • Runs programs on your machine: no
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: no
  • Shows something on screen: no
Hooked events
Screenshot of code-modernization

A large plugin by Anthropic for modernizing legacy code. Start with /modernize: it assesses the codebase, maps it, mines the business rules from the code and writes a plan you approve, then upgrades, rewrites or rebuilds it, with proof that the new code behaves like the old.

The mod part is the live progress pane: a pane beside the transcript with the map of your code, how far each part has got, each module's proof verdict and what to run next. Its commands are /modernize-panel to show or hide it, /modernize-review-pane to review flagged business rules one card at a time, and /modernize-sign to fill in the plan's approval block. The rest of the plugin works without the pane.

Good to know

  • The pane and its three commands are early access: start Claude Code with CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1. Without it they are not there and the rest works as usual.
  • While the pane is on, it adds short notes from the analysis to Claude's context when Claude reads a legacy file (the X-ray reads option) and a status line to each prompt. It never blocks a tool call or sends a prompt.
  • The plugin sends usage counts, whole numbers only, through Claude Code's own telemetry: never code, names, paths or prompts. Once per plugin version it also reports a few facts about your setup, such as the OS and Python version, at session start, even in a session where you do not use it. Turn it off with the plugin's Usage counts option, CODE_MODERNIZATION_TELEMETRY=0, DISABLE_TELEMETRY=1 or CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1. Its README lists every number it sends.
  • Its classic hooks run a shell script, so Windows needs Git Bash. The map, report and proof steps need Python 3.8 or later.

Listed in the official Claude plugin directory, which is where you install it from.

Made this mod? Add a badge to your README

modsforClaude badge for code-modernization

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/code-modernization.svg)](https://modsforclaude.com/mods/code-modernization/)

← All mods