@focusmcp/rename

Rename refactoring — rename symbols across files, rename files with import updates, bulk rename with preview.

Measured economy

Static benchmark — no LLM, no variance, reproducible:

| Tool | Native equivalent | Brick output | Savings | |---|---:|---:|---:| | ren_preview | 2,678 tokens | 1,401 tokens | -47.3% |

Conditions: payload-only measurement (iso-call). Multi-turn agent dynamics not modeled. See global benchmark for methodology and full per-tool table.

Tools

| Tool | Exposed as | Description | |------|-----------|-------------| | symbol | ren_symbol | Rename a symbol across all matching files (dry run by default) | | file | ren_file | Rename a file and update all imports referencing it | | bulk | ren_bulk | Rename multiple symbols in one coordinated operation | | preview | ren_preview | Preview all occurrences of a symbol without mutating files |

Usage

Dry run (default)

All tools default to apply: false, returning a preview of changes without touching the filesystem.

Symbol rename

{
  "tool": "ren_symbol",
  "dir": "/project/src",
  "oldName": "handleRequest",
  "newName": "processRequest",
  "apply": true
}

File rename with import updates

{
  "tool": "ren_file",
  "path": "/project/src/utils.ts",
  "newName": "helpers.ts",
  "dir": "/project/src",
  "apply": true
}

Bulk rename

{
  "tool": "ren_bulk",
  "dir": "/project/src",
  "renames": [
    { "oldName": "Foo", "newName": "Bar" },
    { "oldName": "fooHelper", "newName": "barHelper" }
  ],
  "apply": true
}

Preview occurrences

{
  "tool": "ren_preview",
  "dir": "/project/src",
  "oldName": "legacyMethod"
}