How does File ensure edit safety and consistency?

File preserves encoding, BOM, and newline styles by default. It uses `base_hash` to guard against concurrent user edits and normalizes all internal text to `\n` for consistent operations.

What is File (file-mcp)?

File (file-mcp) is an agent-friendly server primarily for Windows, enabling deterministic and encoding-safe programmatic code editing for automated agents.

What common issues does File address?

It resolves problems common in shell editing, such as command-length limits, BOM handling, newline drift, and preventing overwrites during concurrent file changes.

Is File suitable for large files or generated content?

Yes, it supports atomic multi-edit commits and chunked large-file writes, making it ideal for managing very large generated outputs efficiently.

File

Name: File
Author: yun-wulian

byyun-wulian

0•

Herramientas para Desarrolladores

Productividad y Flujo de Trabajo

Despliegue y DevOps

Provides an agent-friendly server for deterministic, encoding-safe code editing, addressing common issues like command-length limits and newline drift.

File is a Windows-first server designed to facilitate robust and reliable code editing for automated agents. It addresses the inherent fragility of traditional shell editing, inline patches, or full-file rewrites, which often struggle with command-length limits, BOM handling, newline inconsistencies, or concurrent file changes. By offering a standardized editing model, File ensures encoding and style preservation, handles mixed newline files, and provides granular control over text modifications through various methods like span edits, line-range edits, and marker-based replacements, all while guarding against overwrites with `base_hash` checks and supporting atomic multi-edit commits.

Características Principales

010 GitHub stars

02Preserves encoding, BOM, newline style, and trailing newline by default when editing existing files.

03Offers diverse editing primitives including search-then-patch, offset-based span edits, line-range edits, and marker-delimited block replacements.

04Supports atomic multi-edit commits and chunked large-file writes for generated content.

05Normalizes internal text to `\n` and accepts `LF` or `CRLF` text inputs for consistent editing operations.

06Guards writes with `base_hash` to prevent overwriting concurrent user edits.

Casos de Uso

01Automating code transformations and refactoring tasks by software agents.

02Applying precise, encoding-safe patches to codebases without risking file corruption or style inconsistencies.

03Generating or modifying very large files in a chunked, atomic manner with built-in concurrency safeguards.