emend

A Python refactoring CLI built on tree-sitter with a Rust backend. The name means "to make corrections to a text" — which is what it does, but with AST-aware precision instead of find-and-replace.

Two complementary systems: structured edits use selectors like file.py::func[params][0] for precise changes to symbol metadata, and pattern transforms use capture variables like print($X) → logger.info($X) for code-pattern search and replace.

Installation

Using uv with free-threaded Python (recommended for best performance)

uv tool install --python 3.13t emend

Python 3.13+ ships a free-threaded variant (3.13t, 3.14t) that removes the GIL. emend's Rust core (emend_core) is already GIL-free (built with #[pymodule(gil_used = false)]), so on free-threaded Python it can run parallel file scans with no lock contention — meaning find, lint, analyze refs, and edit rename across large codebases are significantly faster.

We recommend 3.13t for the free-threaded interpreter. The 3.14t variant also works for core emend commands, but the optional MCP server (emend mcp) depends on Pydantic which does not yet support Python 3.14t (as of February 28, 2026):

uv tool install --python 3.13t emend   # free-threaded 3.13 (recommended)
uv tool install --python 3.14t emend   # free-threaded 3.14 (no MCP server support)

Using uv (standard Python)

uv tool install emend

Using pip

pip install emend

MCP server

To use emend as an MCP server for LLM-based clients, install the optional mcp extra:

pip install emend[mcp]

Then start the server:

emend mcp                              # stdio transport (default)
emend mcp --transport sse --port 8080  # SSE transport

Note: The MCP server requires Pydantic, which does not support Python 3.14t as of February 28, 2026. Use Python 3.10–3.13 (including 3.13t) for MCP server mode.

Adding emend to Claude Code

The quickest way is the claude mcp add CLI:

# Add for the current project (default scope: local)
claude mcp add --transport stdio emend -- emend mcp

# Or share with your team via .mcp.json (project scope)
claude mcp add --transport stdio --scope project emend -- emend mcp

If you installed with uv tool install, make sure the emend binary is on your PATH, or use the full path:

claude mcp add --transport stdio emend -- uvx emend mcp

You can also add it by editing configuration JSON directly. For a personal setup, run:

claude mcp add-json emend '{"type":"stdio","command":"emend","args":["mcp"]}'

For a team-shared setup, add a .mcp.json file to your project root (and commit it to version control):

{
  "mcpServers": {
    "emend": {
      "type": "stdio",
      "command": "emend",
      "args": ["mcp"]
    }
  }
}

Verify it's connected:

claude mcp list          # from the terminal

Or inside Claude Code, type /mcp to see all connected servers and their status.

See the Claude Code MCP documentation for details on scopes, environment variables, and managed configurations.

Run emend --help to verify. Full documentation at lucaswiman.github.io/emend.

Vim / Neovim plugin

emend ships with a Vim/Neovim plugin for interactive code search. Install with vim-plug:

Plug 'lucaswiman/emend', { 'rtp': 'vim' }

Then use :Emend to open the search prompt, or :Emend parse to search directly. The plugin communicates with emend tool editor-server via JSON-RPC over stdio pipes — the server stays warm for sub-5ms lookups.

For local development, point to your checkout:

Plug '~/src/emend', { 'rtp': 'vim' }
let g:emend_command = '~/src/emend/.venv/bin/emend'

See vim/README.md for full documentation.

Indexing (recommended for large codebases)

After installing, run emend tool index in your project root to pre-build caches:

emend tool index                  # index current directory
emend tool index src/ --jobs 8    # index specific directory with 8 workers

This parses every Python file and builds a qualified-name index, so subsequent cross-project operations (analyze refs, edit rename, analyze graph, analyze deadcode) are significantly faster. The cache is stored in .emend/cache/parse.db (automatically gitignored and dockerignored) and is keyed by file content hash, so it self-invalidates when files change. Git worktrees automatically share a single cache with the main repo. Re-run after large merges or branch switches.

When using the MCP server (emend mcp), indexing happens automatically in the background on startup.

MCP Server

The MCP server now uses a smaller discriminated tool surface:

search — Code search, symbol lookup, and summary listing
transform — Pattern replace plus selector-based edits, adds, removes, copies, moves, and renames
references — References, callers, and callees
analyze — Graph, deadcode, impact, semantic context, and flow analysis
check — Unified project rules from .emend/rules.yaml
mappings — Cross-repo identifier and module mappings
grammar_and_cookbook — Syntax reference and cookbook text

See the grammar_and_cookbook.rst reference for full command documentation.

Usage

emend <command> [options]

Workflow

All mutating commands default to dry-run, showing a diff of proposed changes. Re-run with --apply to write them. You'll probably want to run a formatter (black/ruff/isort) afterward, since emend doesn't try to preserve exact formatting.

Selector Syntax

Three types of selectors:

Symbol Selectors

file.py::Class.method.nested   # Nested symbol path
file.py::func                  # Module-level symbol

Extended Selectors (with components)

file.py::func[params]           # Function parameters
file.py::func[params][ctx]      # Specific parameter (by name)
file.py::func[params][0]        # Specific parameter (by index)
file.py::func[returns]          # Return annotation
file.py::func[decorators]       # Decorator list
file.py::MyClass[bases]         # Base classes
file.py::func[body]             # Function body

Pseudo-class Selectors

file.py::func[params]:KEYWORD_ONLY       # Keyword-only parameter slot
file.py::func[params]:POSITIONAL_ONLY    # Positional-only parameter slot

Line Selectors

file.py:42                      # Single line
file.py:42-100                  # Line range

Wildcard Selectors

file.py::*[params]              # All function parameters
file.py::Test*[decorators]      # Test class parameters
file.py::*.*[returns]           # All method return types
file.py::Class.*[body]          # All method bodies in Class

Wildcards support glob patterns:

* - Match any symbol at this level
Test* - Match symbols starting with Test
*.* - Match any method in any class
Class.* - Match any method in Class

Selector Grammar (Lark)

start: selector

selector: file_path DOUBLE_COLON symbol_path? component*

file_path: PATH
symbol_path: symbol_segment ("." symbol_segment)*
symbol_segment: WILDCARD | IDENTIFIER
component: "[" COMPONENT_NAME "]" accessor? pseudo_class?
accessor: "[" (IDENTIFIER | INT) "]"
pseudo_class: PSEUDO_CLASS

COMPONENT_NAME: "params" | "returns" | "decorators" | "bases" | "body" | "imports"
DOUBLE_COLON: "::"
PATH: /[^:]+/
WILDCARD: "*" | /[a-zA-Z_*][a-zA-Z0-9_*]*/
IDENTIFIER: /[a-zA-Z_][a-zA-Z0-9_]*/
INT: /-?\d+/
PSEUDO_CLASS: /:KEYWORD_ONLY|:POSITIONAL_ONLY|:POSITIONAL_OR_KEYWORD/

Commands

The public CLI is organized around a small set of top-level commands:

find — Search for patterns, selectors, symbols, or summaries.
edit — Code changes and refactors. Subcommands: set, rm, delete, add, replace, cp, rename, mv, batch, saturate.
analyze — Read-only analysis. Subcommands: refs, graph, deadcode, impact, types, trace, facts, cfg, dsl.
tool — Operational and debugging commands. Subcommands: index, editor-search, editor-server, query.
check — Unified project rules from .emend/rules.yaml.
lint / policy — Focused rule runners kept for compatibility and targeted workflows.
map — Identifier and module mappings.
mcp — Start the MCP server.

Hidden compatibility aliases still work. For example, emend rm ... maps to emend edit rm ..., and old read commands like search, grep, show, get, and lookup route to emend find.

Examples

Search & Read Examples

# Search by pattern (pattern mode)
emend find 'print($X)' src/
emend find 'assertEqual($A, $B)' tests/ --output count

# Search by symbol (lookup mode)
emend find file.py::func
emend find src/ --kind function --name test_*
emend find file.py --output json

# Extract function parameters
emend find api.py::handler[params]
emend find 'api.py::*[params]'  # Wildcard: all function params in file

# Get return types
emend find 'src/**/*.py::*[returns]' --output metadata

# List symbols in a module
emend find file.py                          # Tree view
emend find file.py --output summary::flat   # Flat list
emend find file.py --depth 2                # Limit nesting depth

Edit Examples

# Update return type
emend edit set api.py::handler[returns] "Response" --apply

# Add parameter with default value
emend edit add api.py::handler[params] "timeout: int = 30" --apply

# Add keyword-only parameter
emend edit add "api.py::handler[params]:KEYWORD_ONLY" "debug: bool" --apply

# Insert parameter before specific param
emend edit add api.py::handler[params] "ctx: Context" --before user_id --apply

# Remove a specific parameter
emend edit rm api.py::handler[params][deprecated_arg] --apply

# Edit multiple symbols at once (wildcards)
emend edit set 'file.py::*[decorators]' "@dataclass" --apply

Pattern Transform Examples

# Simple find and replace (dry-run by default)
emend edit replace 'print($X)' 'logger.info($X)' file.py

# Replace within a specific scope
emend edit replace 'old_var' 'new_var' api.py --where process --apply

# Replace with pattern capture
emend edit replace 'get_field($N)' 'field$N' api.py --where process --apply

# String content interpolation: ${X.content} strips quotes from a captured string literal
emend edit replace 'Union["$X", $Y]' '$X | $Y' src/ --apply

# Find all pattern matches
emend find 'print($X)' src/ --output location

# Multi-rule batch operations
emend edit batch rules.json --apply

Symbol Management Examples

# Find all references to a symbol
emend analyze refs models.py::User --json
emend analyze refs models.py::User --writes-only    # Only write references
emend analyze refs models.py::User --calls-only     # Only function calls

# Rename a symbol project-wide
emend edit rename models.py::User --to Account --apply

# Move a symbol to another file (updates imports)
emend edit mv utils.py::parse_date helpers/dates.py --apply

# Copy a symbol to another file
emend edit cp workflow.py::Builder._build.helper tasks.py --dedent --apply

# Remove a symbol or component
emend edit rm file.py::deprecated_func --apply

# List symbols using find
emend find workflow.py --depth 3

Pattern Syntax

Patterns support metavariables for capturing:

# Single expression
emend find 'print($MSG)' src/

# Multiple arguments with capture
emend find 'func($A, $B)' src/

# Variable arguments
emend find 'func($...ARGS)' src/

# Type constraints
emend find 'range($N:int)' src/

# Anonymous metavariables
emend find 'func($_, $ARG)' src/

# Structural constraints (via --where)
emend find 'print($X)' src/ --within 'async def'
emend find 'await $X' src/ --where 'not if __debug__'

# Supported pattern types:
#   Literals: $X, $MSG:str, $N:int, 3.14
#   Calls: func($X), obj.method($A, $B)
#   Operations: $A + $B, $A and $B, not $X, $X[$Y]
#   Collections: ($A, $B), [$X, $Y], {$K: $V}
#   Control: return $X, assert $A == $B, raise $EXC

Pattern Grammar (Lark)

start: pattern

pattern: (code_chunk | metavar)+

metavar: DOLLAR (ELLIPSIS)? METAVAR_NAME TYPE_CONSTRAINT?
       | DOLLAR UNDERSCORE

DOLLAR: "$"
ELLIPSIS: "..."
UNDERSCORE: "_"
METAVAR_NAME: /[A-Z][A-Z0-9_]*/
TYPE_CONSTRAINT: /:!?(?:expr|stmt|identifier|int|str|float|call|attr|any)/
code_chunk: /[^$:]+/ | ":"

The code_chunk rule excludes colons (/[^$:]+/) to prevent consuming colons that are part of type constraints (e.g., $MSG:str). A standalone colon is matched by the alternative | ":" for patterns containing colons outside of type constraints.

Diff Patch Format

- pattern_to_find
+ replacement_pattern

- another_pattern
+ another_replacement

Lines prefixed with - are matched; corresponding + lines are the replacement. Blank lines separate rules.

Linting

emend's canonical rules file is .emend/rules.yaml. emend check is the unified entry point, while emend lint and emend policy remain available for focused workflows and compatibility.

# .emend/rules.yaml
macros:
  print_call: "print($...ARGS)"

rules:
  no-print:
    match: "{print_call}"
    not-within: "def test_*"
    message: "Use logger instead of print"
    fix: "logger.info($...ARGS)"

  no-open-without-encoding:
    match: "open($PATH)"
    message: "Specify encoding when calling open()"
    fix: "open($PATH, encoding='utf-8')"

# Run all configured checks
emend check src/

# Auto-fix match rules that have a fix
emend check src/ --fix

# Focus on match-style lint rules only
emend lint src/ --rule no-print

Suppress violations inline with # noqa comments:

print("keep this")  # noqa
print("keep this")  # noqa: emend:no-print
print("keep this")  # noqa: E501, emend:no-print  # mixed with other linters

Dead code detection

Dead code can be configured in .emend/rules.yaml and run either through emend check or directly through emend analyze deadcode:

# .emend/rules.yaml
deadcode: true

# Or with options:
deadcode:
  enabled: true
  kind: function                          # Only functions (or "class")
  exclude-references-from: ["tests/"]     # Ignore refs from tests
  include-private: false                  # Skip _private symbols
  strings-count-as-references: true       # String literals count as refs
  message: "Symbol appears to be unused"

# Run as part of unified checks
emend check src/

# Or use the standalone command
emend analyze deadcode src/
emend analyze deadcode src/ --exclude-references-from tests/ --json
emend analyze deadcode src/ --unused-modules

Suppress false positives inline:

def my_entry_point():  # noqa: emend:deadcode
    ...

Mapping Store

emend includes a built-in mapping store for cross-service identifier mappings and module-to-repo mappings. Stored in .emend/mappings.yaml.

# Identifier mappings — cross-service relationships
emend map add backend "UserService.create" gateway "POST /api/v1/users" \
    --source-kind function --target-kind endpoint
emend map search "UserService"

# Module mappings — map module prefixes to repos or local dirs
emend map add-module payments --repo org/payments-service
emend map add-module shared.utils --path /home/user/shared-utils
emend map resolve payments.models.Order

Module mappings that reference GitHub repos are automatically cloned (via gh) and checked out as git worktrees under ~/.cache/emend/repo-checkouts/. Set EMEND_CACHE_DIR to relocate this cache.

pre-commit integration

emend can run as a pre-commit hook. Add to your .pre-commit-config.yaml:

repos:
  - repo: https://github.com/lucaswiman/emend
    rev: v0.2.0  # replace with desired version tag
    hooks:
      - id: emend-lint

This runs emend lint on staged Python files using your .emend/rules.yaml config.

To auto-fix violations, add args: ["--fix"] to the hook configuration.

Development

Installing from Source

Clone the repository and install for development:

git clone https://github.com/lucaswiman/emend
cd emend

# Using make (creates a free-threaded venv, compiles the Rust extension, installs dev deps)
make venv

# Or manually (requires maturin and a Rust toolchain):
uv venv .venv --python 3.13t
uv pip install maturin
.venv/bin/maturin develop -E dev

Running Tests

# Run all tests
make test

# Run specific test file
make test TESTS=tests/test_emend/test_add_parameter.py

# Run specific test
make test TESTS="tests/test_emend/test_add_parameter.py::test_add_parameter_with_default"

Project Structure

emend/
├── src/emend/
│   ├── cli.py                # CLI assembly and compatibility layer
│   ├── cli_find.py           # `find`
│   ├── cli_edit.py           # `edit` subcommands
│   ├── cli_analysis.py       # `analyze` subcommands
│   ├── cli_tooling.py        # `tool` and `mcp`
│   ├── cli_checks.py         # `check`, `lint`, `policy`
│   ├── cli_map.py            # `map`
│   ├── transform.py          # Core search/edit/analysis engine
│   ├── pattern.py            # Pattern parsing and compilation
│   ├── query.py              # Symbol querying with filters
│   ├── ast_commands.py       # AST-based command implementations
│   ├── ast_utils.py          # AST traversal utilities
│   ├── component_selector.py # Extended selector parsing
│   ├── lint.py               # Pattern-based linter engine
│   ├── mcp_server.py         # MCP server (optional, requires emend[mcp])
│   └── grammars/
│       ├── selector.lark     # Extended selector grammar
│       └── pattern.lark      # Pattern grammar
├── rust/                     # emend_core Rust extension (bundled in wheel)
│   ├── src/lib.rs            # PyO3 bindings, GIL-free module definition
│   └── Cargo.toml
├── vim/                      # Vim/Neovim plugin (JSON-RPC over stdio)
│   ├── plugin/emend.vim      # Commands (:Emend, :EmendSearch, etc.)
│   ├── autoload/emend.vim    # RPC client, server lifecycle
│   ├── autoload/emend/ui.vim # Split-pane search UI
│   └── doc/emend.txt         # Vim help (:help emend)
├── tests/test_emend/         # Test suite
├── Makefile
└── pyproject.toml            # maturin build (bundles Rust + Python in one wheel)

License

MPL 2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

emend-0.4.0.tar.gz (479.1 kB view details)

Uploaded Jul 10, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

emend-0.4.0-cp314-cp314t-win_amd64.whl (8.5 MB view details)

Uploaded Jul 10, 2026 CPython 3.14tWindows x86-64

emend-0.4.0-cp314-cp314t-manylinux_2_39_x86_64.whl (9.4 MB view details)

Uploaded Jul 10, 2026 CPython 3.14tmanylinux: glibc 2.39+ x86-64

emend-0.4.0-cp314-cp314t-manylinux_2_39_aarch64.whl (9.6 MB view details)

Uploaded Jul 10, 2026 CPython 3.14tmanylinux: glibc 2.39+ ARM64

emend-0.4.0-cp314-cp314t-macosx_11_0_arm64.whl (8.7 MB view details)

Uploaded Jul 10, 2026 CPython 3.14tmacOS 11.0+ ARM64

emend-0.4.0-cp314-cp314t-macosx_10_12_x86_64.whl (8.8 MB view details)

Uploaded Jul 10, 2026 CPython 3.14tmacOS 10.12+ x86-64

emend-0.4.0-cp314-cp314-win_amd64.whl (8.5 MB view details)

Uploaded Jul 10, 2026 CPython 3.14Windows x86-64

emend-0.4.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (9.3 MB view details)

Uploaded Jul 10, 2026 CPython 3.14manylinux: glibc 2.17+ x86-64

emend-0.4.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (9.5 MB view details)

Uploaded Jul 10, 2026 CPython 3.14manylinux: glibc 2.17+ ARM64

emend-0.4.0-cp314-cp314-macosx_11_0_arm64.whl (8.7 MB view details)

Uploaded Jul 10, 2026 CPython 3.14macOS 11.0+ ARM64

emend-0.4.0-cp314-cp314-macosx_10_12_x86_64.whl (8.8 MB view details)

Uploaded Jul 10, 2026 CPython 3.14macOS 10.12+ x86-64

emend-0.4.0-cp313-cp313t-win_amd64.whl (8.5 MB view details)

Uploaded Jul 10, 2026 CPython 3.13tWindows x86-64

emend-0.4.0-cp313-cp313t-manylinux_2_39_x86_64.whl (9.4 MB view details)

Uploaded Jul 10, 2026 CPython 3.13tmanylinux: glibc 2.39+ x86-64

emend-0.4.0-cp313-cp313t-manylinux_2_39_aarch64.whl (9.6 MB view details)

Uploaded Jul 10, 2026 CPython 3.13tmanylinux: glibc 2.39+ ARM64

emend-0.4.0-cp313-cp313t-macosx_11_0_arm64.whl (8.7 MB view details)

Uploaded Jul 10, 2026 CPython 3.13tmacOS 11.0+ ARM64

emend-0.4.0-cp313-cp313t-macosx_10_12_x86_64.whl (8.8 MB view details)

Uploaded Jul 10, 2026 CPython 3.13tmacOS 10.12+ x86-64

emend-0.4.0-cp313-cp313-win_amd64.whl (8.5 MB view details)

Uploaded Jul 10, 2026 CPython 3.13Windows x86-64

emend-0.4.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (9.3 MB view details)

Uploaded Jul 10, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64

emend-0.4.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (9.5 MB view details)

Uploaded Jul 10, 2026 CPython 3.13manylinux: glibc 2.17+ ARM64

emend-0.4.0-cp313-cp313-macosx_11_0_arm64.whl (8.7 MB view details)

Uploaded Jul 10, 2026 CPython 3.13macOS 11.0+ ARM64

emend-0.4.0-cp313-cp313-macosx_10_12_x86_64.whl (8.8 MB view details)

Uploaded Jul 10, 2026 CPython 3.13macOS 10.12+ x86-64

emend-0.4.0-cp312-cp312-win_amd64.whl (8.5 MB view details)

Uploaded Jul 10, 2026 CPython 3.12Windows x86-64

emend-0.4.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (9.3 MB view details)

Uploaded Jul 10, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64

emend-0.4.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (9.5 MB view details)

Uploaded Jul 10, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64

emend-0.4.0-cp312-cp312-macosx_11_0_arm64.whl (8.7 MB view details)

Uploaded Jul 10, 2026 CPython 3.12macOS 11.0+ ARM64

emend-0.4.0-cp312-cp312-macosx_10_12_x86_64.whl (8.8 MB view details)

Uploaded Jul 10, 2026 CPython 3.12macOS 10.12+ x86-64

emend-0.4.0-cp311-cp311-win_amd64.whl (8.5 MB view details)

Uploaded Jul 10, 2026 CPython 3.11Windows x86-64

emend-0.4.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (9.3 MB view details)

Uploaded Jul 10, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64

emend-0.4.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (9.5 MB view details)

Uploaded Jul 10, 2026 CPython 3.11manylinux: glibc 2.17+ ARM64

emend-0.4.0-cp311-cp311-macosx_11_0_arm64.whl (8.7 MB view details)

Uploaded Jul 10, 2026 CPython 3.11macOS 11.0+ ARM64

emend-0.4.0-cp311-cp311-macosx_10_12_x86_64.whl (8.8 MB view details)

Uploaded Jul 10, 2026 CPython 3.11macOS 10.12+ x86-64

emend-0.4.0-cp310-cp310-win_amd64.whl (8.5 MB view details)

Uploaded Jul 10, 2026 CPython 3.10Windows x86-64

emend-0.4.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (9.3 MB view details)

Uploaded Jul 10, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64

emend-0.4.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (9.5 MB view details)

Uploaded Jul 10, 2026 CPython 3.10manylinux: glibc 2.17+ ARM64

emend-0.4.0-cp310-cp310-macosx_11_0_arm64.whl (8.7 MB view details)

Uploaded Jul 10, 2026 CPython 3.10macOS 11.0+ ARM64

emend-0.4.0-cp310-cp310-macosx_10_12_x86_64.whl (8.8 MB view details)

Uploaded Jul 10, 2026 CPython 3.10macOS 10.12+ x86-64

File details

Details for the file emend-0.4.0.tar.gz.

File metadata

Download URL: emend-0.4.0.tar.gz
Upload date: Jul 10, 2026
Size: 479.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for emend-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`66b7a51409eec4779cd368ad05695a70269ef0b84f9da23ee1eb4a96730033e5`
MD5	`f641fa409c79de4ad5dd18b82c14f523`
BLAKE2b-256	`97e9f19e3146eb10d281eaf293428a9af0f96f12ba4504960e3943f83e1ea7ad`

Algorithm	Hash digest
SHA256	`e761337cee43faf6f2087e0199a2ad0c2e271634483025ad28e30dc6b2ad8598`
MD5	`55b98e10c9f0fd9c092a6fcffbd5f53c`
BLAKE2b-256	`e26ee06cdfb8c6a4610bd7c75bf6d8a7640a70ec44bc5fe4e1568cad1b9c4e8c`

Algorithm	Hash digest
SHA256	`f19457c8c267fb465c10980f60cdb5d1be4e65a75e3839d2f500905b614a3f90`
MD5	`723e997e7d9aa0571f62b565bf05c07a`
BLAKE2b-256	`1d959c5790f21d9f43a7055cfc4f7418f81be1648bfc97083f7561c7142ab69e`

Algorithm	Hash digest
SHA256	`8d7380dd13678ce45283933959d04bd27b675978a7e03e556ac222321f33c767`
MD5	`e34fc3247637d15bec7ed75bd5af6a23`
BLAKE2b-256	`811046f388044e1a65879d98d74c822be2f2ee65e405d8e6f38f08332cb966e2`

Algorithm	Hash digest
SHA256	`0e0a15869c272f5d716a41cd888ce4db52b10ca2967c3db6304cc160e9f04f6b`
MD5	`6bf3878f9313cac83f3ef6336df88245`
BLAKE2b-256	`23651fc62abf5dee80e749157a66653e7f7014ecc1d32ebe7ed060c00cf2931b`

Algorithm	Hash digest
SHA256	`051f03a59c616ea17451a4912781e13073e3862b6e9ca8a7ef0fe4f3f272539c`
MD5	`b0a624a682491273b746a085f2dfac17`
BLAKE2b-256	`5cc2ceeb677b76bf4f7c158325bfaeab1c86405abb6b2de5728f94ce780dfd39`

Algorithm	Hash digest
SHA256	`a381a404e41c94bb87d39fb69dda4f1957485c7bcdad784ca0adf7a942ab030b`
MD5	`5090546fa2638188d499a0bde4597860`
BLAKE2b-256	`def5d8e42afeba5dcba76f4a08ba0116f12fa34af2ec306cad505d8b046166a0`

Algorithm	Hash digest
SHA256	`86f82c9e2aa6c0a178dc127a8ddc39439440eb76bfc37e21161275337ebf5e85`
MD5	`8420953aa2fa00bdbd807693384357a4`
BLAKE2b-256	`a30ad0fa124ac78f9f5d86b106c544f2bd81b2465f4b5c13c0871c68ba27e01a`

Algorithm	Hash digest
SHA256	`7998a1624c7b6fd83e40bc2d6c945cbc0bcce43ed498d40c4074109b9561d1af`
MD5	`10fa9c241f6f7853d19dcc4cb55a0ba4`
BLAKE2b-256	`f94c733e37074b3655969cc42a81ccc57e6c6ff769249996b7cad046e1008b13`

Algorithm	Hash digest
SHA256	`81de6b77cd8d6109f5da31eb026dbb156de25a18b479629263a51e0d508ce700`
MD5	`a6c7c71129eada86abf8a83e70b15e0e`
BLAKE2b-256	`0a18954ea9bc5bc669e5fb37475435d405aa0dc0d364807d3e4a7dd9fa019d3d`

Algorithm	Hash digest
SHA256	`a2745a5298623bf97c90e4165daa8a4fd26925bd6cd3521e4f4f54b38ef2f29e`
MD5	`ec37e992c2b1d09186cc31ab74f6019a`
BLAKE2b-256	`c8c139fd7fa3fbc873e02b8b83bf4bef7f92b555117ea37d28a20bee79a2ce8c`

Algorithm	Hash digest
SHA256	`3abff6190caf8ef77581ed13288c0dc5d8d884556bbb1eb883afe43a8469bd76`
MD5	`40945b37224c90f32df5758f0734a223`
BLAKE2b-256	`788016f986786077183204f7c2c6f516b1416a53b90207e4d9a9c5ef3904974e`

Algorithm	Hash digest
SHA256	`080f82b4701da93c609173cefb944cbafeeee311dd0a6258ca5dcfe26c9b6e96`
MD5	`92ac983ab815a940684883ed0220e8e3`
BLAKE2b-256	`e97664b39350b58467f97160c3aee99ed291996874b6bce7915cb11fa83be226`

Algorithm	Hash digest
SHA256	`19001d5f3f96d78165681ec22da92b87af2e07dffcaa2abd89548162777b224e`
MD5	`6c4787ce3730c79a3a43cda0e11c1c82`
BLAKE2b-256	`ac260dfdc7fa91916cfb67700b1dc0169e66b8f5aed553e08fdb01e767010d18`

Algorithm	Hash digest
SHA256	`e28eacdabf10570e0774a0240289b3f57becfd65688572caab46135c25545184`
MD5	`0e750b73fe343e6611ddb1c90ec4eb7e`
BLAKE2b-256	`fcaa8336015c36d984161e6c1dccf56a07f6ff4f4691a4078d93b0974b6370c4`

Algorithm	Hash digest
SHA256	`1c9507cfe3d0ded29a8eeaec7144f18c672e48693fc3dea97c9a11af9624bd12`
MD5	`4a5653dfd237121be91352d2c5305902`
BLAKE2b-256	`0b84659bd788e76a38e4608696d3b75693968d705c07db66573d81e2b92f7d5a`

Algorithm	Hash digest
SHA256	`d4b1cbf1fd093bfac6bcad9157a5c9ca242c24dc4b03a811e0bc451ccc4aaf63`
MD5	`d88d63f069081ef3a7c61788cc05729d`
BLAKE2b-256	`0a36f3fb5f1de42081844fda9719efb5627e9e5f491aafd5ea04a47cc6108070`

Algorithm	Hash digest
SHA256	`f1f63920d5a1e3b311bc97c55506b8ca186ac304be8874d14e8edf2060b87289`
MD5	`5fe1839ff08de7c8938d68582ba987b8`
BLAKE2b-256	`6ee759fbb3c2b88786054abf42656e091232247ca56619f2967aeaf61e5ed257`

Algorithm	Hash digest
SHA256	`a40691181ef3779873804f27792bc7cae5b30dd5f6131f7828f9cc09c957566d`
MD5	`28e4d44975b76842bb365cff74793dc2`
BLAKE2b-256	`f4bbc173a592866906b902d3e392a963bb8e5901e10e6c3de746cf3816f4ae34`

Algorithm	Hash digest
SHA256	`5bd2806a2e0fd48e2e429631dfba160157dc3b80ddadf02538d927333d354f8e`
MD5	`6096e47bd5a5a613049ab31143a898aa`
BLAKE2b-256	`2dc211fd898f335566b1446b267f00656b2d380fcd30059e9424aeb8d539f0e2`

Algorithm	Hash digest
SHA256	`a371d0f22f3894f071969f44d68c9947edda63cb5cbde5f3f293c1ca7f27c244`
MD5	`efd707fbfa7d02ef55335b2fd0b17478`
BLAKE2b-256	`ac12cf3aed1ac0f934ac233cf148cb414d853269f07643a70ff0425cfae30ea4`

emend 0.4.0

emend

Installation

Using uv with free-threaded Python (recommended for best performance)

Using uv (standard Python)

Using pip

MCP server

Adding emend to Claude Code

Vim / Neovim plugin

Indexing (recommended for large codebases)

MCP Server

Usage

Workflow

Selector Syntax

Symbol Selectors

Extended Selectors (with components)

Pseudo-class Selectors

Line Selectors

Wildcard Selectors

Selector Grammar (Lark)

Commands

Examples

Search & Read Examples

Edit Examples

Pattern Transform Examples

Symbol Management Examples

Pattern Syntax

Pattern Grammar (Lark)

Diff Patch Format

Linting

Dead code detection

Mapping Store

pre-commit integration

Development

Installing from Source

Running Tests

Project Structure

License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

Algorithm	Hash digest
SHA256	`d7978d9ee7cc12201718ed45259507f73a1f6beec7554f3e4c689361679e238d`
MD5	`02aacd8cd22dd30ca14d4fdc19059e66`
BLAKE2b-256	`bd6466b4338dd759635c05dfdd7b468cc2ba54c796a0cdf1a310845465b32b4f`

Algorithm	Hash digest
SHA256	`bd5dab19c004325b4a263568e0076e60df3a8922572953e44ee983258b38b07d`
MD5	`704ed87da718f2a1c649966f25a8494f`
BLAKE2b-256	`7f9d0f1f539cd68ffcf192f106d435c8cc4f4402bdf8aadc2156c063ae903113`

Algorithm	Hash digest
SHA256	`3c2c29e7e229874e65dbbd70e7cd734697d20b28be45c8986f66433d3a644760`
MD5	`dee64b8c156f430bb9bab256a208926a`
BLAKE2b-256	`e0fc78621a05be2f5248d429ade6077a98f0847328a587c5c3b0823a620579e0`

Algorithm	Hash digest
SHA256	`ebaa739f10ab25367b0deeba5d9600407120f4efb4584a5d348c19dd956a5ea1`
MD5	`35aba986b07f138b5ad128ba2b19e2d8`
BLAKE2b-256	`b2c61d82de00dadae3a5cf3ba51ea4130998d9bbd79c8237852339c3d551b698`

Algorithm	Hash digest
SHA256	`1b191a89ba898b936520f4754e1140313061a232d90df786532700b4cb979f80`
MD5	`ac457e755133538550739a44f457f4fd`
BLAKE2b-256	`2b4c3248e698f25732a7542c0201c1853829854596ec55c868c8a6bdd3bfa556`

Algorithm	Hash digest
SHA256	`3137fd9890031297ecf3d1a4cb5920dce6329b7199e079d3545ca9bd216a4014`
MD5	`c47c62b26277b767b516a34f1de9dff5`
BLAKE2b-256	`a17468e476087dfe3bf56c60e017be8ac45d1bde0bc67e47d015b042451c4a92`

Algorithm	Hash digest
SHA256	`15cc74d2e8f5ff9fcfb402ae51f91c2d112a6719bc454d3fcc6b6a45f51acc44`
MD5	`7671ec1345ec8fa19f18b541d8045993`
BLAKE2b-256	`d20b3e970cbb4f9be641c40a60714955dfdf9e18c608e595a73e46ef96217229`

Algorithm	Hash digest
SHA256	`f11fbccaf09eb455619f0a56ee2996573c8511bdf117749753b1475f044e9c01`
MD5	`7ae6941a8780bf1fb9d5a218d7177bcd`
BLAKE2b-256	`3a4a989861de7dc6c49c635328d2be7fa8f47235a20f5a03d7157498d3e34123`

Algorithm	Hash digest
SHA256	`3b829d676db3544bf37a9d5f945fd9cfb5ebba784a074077f6c563a30b287a28`
MD5	`ecf8dfb73722b542b9a018b2f3799dd2`
BLAKE2b-256	`d5ff143cccc89fcf9cd068c66cf692dd95a1710ad42019d5af075c4963978777`

Algorithm	Hash digest
SHA256	`9092d0475da060ed65719e5717d274adf4c1e306a48d475aa9b71a4d90ee9f00`
MD5	`dc51dd92876eb03c23cdc583c62a0e89`
BLAKE2b-256	`8c73a0ee981156cc68df5a12fd16316807baeb06bdbbcb6b28ec57c2a3573218`