Reads the content of a file.

Args:

• path (string): Full path to the file

• encoding (string, optional): Character encoding (default: utf-8)

• max_lines (number, optional): Maximum number of lines (0 = all)

Returns:

• File content as text

• For binary files: Base64-encoded content

Examples:

• path: "C:\Users\User\test.txt"

• path: "/home/user/config.json"

Writes content to a file. Creates the file if it does not exist.

Args:

• path (string): Full path to the file

• content (string): Content to write

• append (boolean, optional): Append to file instead of overwriting

• create_dirs (boolean, optional): Create missing directories

Returns:

• Confirmation with file size

Warning: Overwrites existing files without warning when append=false!

Lists files and subdirectories.

Args:

• path (string): Path to the directory

• depth (number, optional): Maximum depth for recursive listing (default: 1)

• show_hidden (boolean, optional): Show hidden files

Returns:

• Formatted list of all entries with icons

Creates a new directory (including parent directories).

Args:

• path (string): Path to the new directory

Returns:

• Confirmation of creation

Deletes a file.

Args:

• path (string): Path to the file

Warning: Irreversible! No recycle bin.

Deletes a directory.

Args:

• path (string): Path to the directory

• recursive (boolean): Delete non-empty directories too

Warning: With recursive=true ALL contents are irreversibly deleted!

Moves or renames a file/directory.

Args:

• source (string): Source path

• destination (string): Destination path

Examples:

• Rename: source="test.txt", destination="test_new.txt"

• Move: source="C:\a\test.txt", destination="C:\b\test.txt"

Copies a file or directory.

Args:

• source (string): Source path

• destination (string): Destination path

• recursive (boolean): Copy directories recursively

Shows detailed information about a file/directory.

Args:

• path (string): Path to the file/directory

Returns:

• Size, type, creation/modification date, permissions

Searches files by name/pattern in a directory.

Args:

• directory (string): Start directory for the search

• pattern (string): Search pattern (supports * and ? wildcards)

• max_results (number, optional): Maximum results (default: 50)

Examples:

• pattern: "*.txt" - All text files

• pattern: "test*" - Files starting with "test"

• pattern: "*.py" - All Python files

Starts a background search. Claude can perform other tasks in the meantime.

Args:

• directory (string): Start directory

• pattern (string): Search pattern (wildcards: * and ?)

Returns:

• Search ID for fc_get_search_results, fc_stop_search

Example: Start search: fc_start_search("C:\Users", "*.pdf") Get results later: fc_get_search_results(search_id)

Retrieves results of a running or completed search.

Args:

• search_id (string): Search ID from fc_start_search

• offset (number, optional): Start offset for pagination

• limit (number, optional): Maximum number of results (default: 50)

Returns:

• Search status and found files

Stops a running background search.

Args:

• search_id (string): Search ID

Lists all active and completed background searches.

Removes a completed search from the list and frees memory.

Args:

• search_id (string): Search ID (or "all" for all completed)

Moves files/directories to recycle bin instead of deleting them.

Args:

• path (string): Path to the file/directory

SAFE: Can be restored from the recycle bin!

Note: Uses Windows recycle bin or creates backup on other systems.

Executes a shell command and returns the output.

Args:

• command (string): Command to execute

• cwd (string, optional): Working directory

• timeout (number, optional): Timeout in milliseconds (default: 30000)

Warning: Commands are executed with user privileges!

Examples:

• command: "dir" (Windows)

• command: "ls -la" (Unix)

• command: "python --version"

Starts a process in the background (non-blocking).

Args:

• program (string): Program/Executable

• args (array, optional): Arguments as array

• cwd (string, optional): Working directory

Examples:

• program: "notepad.exe", args: ["test.txt"]

• program: "python", args: ["script.py"]

• program: "code", args: ["."] (open VS Code)

Returns the current system time.

Returns:

• Date, time, weekday, timezone

Reads multiple files at once and returns their contents.

Args:

• paths (array): Array of file paths

• max_lines_per_file (number, optional): Max lines per file (0 = all)

Returns:

• Contents of all files with separators

Example: paths: ["C:\config.json", "C:\readme.md"]

Edits a file line-based: replace, insert, or delete.

Args:

• path (string): Path to the file

• operation (string): "replace" | "insert" | "delete"

• start_line (number): Start line (1-based)

• end_line (number, optional): End line for replace/delete

• content (string, optional): New content for replace/insert

Examples:

• Replace lines 5-10: operation="replace", start_line=5, end_line=10, content="new text"

• Insert after line 3: operation="insert", start_line=3, content="new line"

• Delete lines 7-9: operation="delete", start_line=7, end_line=9

Replaces a unique string in a file with another.

Args:

• path (string): Path to the file

• old_str (string): String to replace (must occur exactly once)

• new_str (string): New string (empty = delete)

Returns:

• Confirmation with context

IMPORTANT: old_str must occur EXACTLY once in the file! An error is returned for 0 or >1 occurrences.

Examples:

• Rename function: old_str="def old_name", new_str="def new_name"

• Add import: old_str="import os", new_str="import os\nimport sys"

• Delete line: old_str="# TODO: remove this\n", new_str=""

Lists running system processes.

Args:

• filter (string, optional): Filter by process name

Returns:

• List of processes with PID, name, memory

Note: Uses 'tasklist' (Windows) or 'ps' (Unix)

Terminates a process by PID or name.

Args:

• pid (number, optional): Process ID

• name (string, optional): Process name

• force (boolean): Force termination

Warning: May cause data loss!

Starts an interactive process as a session (for fc_read_output and fc_send_input).

Args:

• command (string): Command/Program

• args (array, optional): Arguments

• cwd (string, optional): Working directory

Returns:

• Session ID for further interaction

Examples:

• Python REPL: command="python"

• Node REPL: command="node"

• PowerShell: command="powershell"

Reads the output of a running session.

Args:

• session_id (string): Session ID from fc_start_session

• clear (boolean, optional): Clear output after reading

Returns:

• Collected output since start/last clear

Sends input to a running session.

Args:

• session_id (string): Session ID

• input (string): Input to send

• newline (boolean, optional): Append newline (default: true)

Examples:

• Python: input="print('Hello')"

• Shell: input="ls -la"

Lists all active and ended sessions.

Returns:

• Table of all sessions with status

Terminates a running session and removes it from the list.

Args:

• session_id (string): Session ID

• force (boolean, optional): Force termination

Automatically repairs common JSON errors.

Args:

• path (string): Path to the JSON file

• dry_run (boolean, optional): Only show problems, do not repair

• create_backup (boolean, optional): Create backup before repair

Repairs: BOM, trailing commas, single quotes, comments, NUL bytes

Validates a JSON file and shows detailed error information.

Args:

• path (string): Path to the JSON file

Returns:

• Validation status with line/column on errors

Cleans up one or more files from common problems.

Args:

• path (string): Path to file or directory

• recursive (boolean, optional): Recursive for directories

• extensions (string, optional): Filter file extensions (e.g. ".txt,.json,.py")

• remove_bom (boolean): Remove UTF-8 BOM

• remove_trailing_whitespace (boolean): Remove trailing whitespace

• normalize_line_endings (string, optional): "lf" | "crlf" | null

• remove_nul_bytes (boolean): Remove NUL bytes

• dry_run (boolean): Preview only

Cleans: BOM, NUL bytes, trailing whitespace, line endings

Detects and repairs encoding errors (mojibake, double UTF-8).

Args:

• path (string): Path to the file

• dry_run (boolean): Only show problems

• create_backup (boolean): Create backup

Repairs common mojibake patterns like:

• ä -> ae, ö -> oe, ü -> ue (German umlauts)

• ß -> ss, € -> EUR

Compares the current state of a directory with a saved snapshot.

Args:

• path (string): Path to the directory

• save_snapshot (boolean): Save current state as new snapshot

• extensions (string, optional): Filter file extensions

Detects: New files, modified files, deleted files Snapshots are saved in %TEMP%/.fc_snapshots/

Renames files by pattern: remove prefix/suffix, replace, or auto-detect.

Args:

• directory (string): Directory with the files

• mode (string): "remove_prefix" | "remove_suffix" | "replace" | "auto_detect"

• pattern (string, optional): Text to remove/replace

• replacement (string, optional): Replacement text (for replace mode)

• extensions (string, optional): Filter by extensions

• dry_run (boolean): Preview only

Examples:

• Remove prefix: mode="remove_prefix", pattern="backup_"

• Auto-detect: mode="auto_detect" detects common prefixes

Converts files between different formats.

Args:

• input_path (string): Path to source file

• output_path (string): Path to target file

• input_format (string): "json" | "csv" | "ini" | "yaml" | "toml" | "xml" | "toon"

• output_format (string): "json" | "csv" | "ini" | "yaml" | "toml" | "xml" | "toon"

• json_indent (number, optional): JSON indentation (default: 2)

Supported conversions:

• JSON <-> CSV (for arrays of objects)

• JSON <-> INI (for flat objects/sections)

• JSON <-> YAML

• JSON <-> TOML

• JSON <-> XML

• JSON <-> TOON (hierarchical key-value format)

• JSON pretty-print / minify

Finds file duplicates in a directory using SHA-256 hashes.

Args:

• directory (string): Directory to scan

• recursive (boolean): Search recursively

• extensions (string, optional): Filter by extensions

• min_size (number, optional): Minimum size in bytes (default: 1)

• max_size (number, optional): Maximum size in bytes

Returns:

• Groups of duplicates with paths and sizes

Converts Markdown to formatted HTML (printable as PDF).

Args:

• input_path (string): Path to Markdown file

• output_path (string): Path to HTML output

• title (string, optional): Document title

Generates standalone HTML with CSS styling, printable as PDF via browser.

Converts Markdown to PDF using a headless browser (Edge/Chrome).

Args:

• input_path (string): Path to the Markdown file

• output_path (string): Path to the PDF output

• title (string, optional): Document title

Uses the same Markdown parser as fc_md_to_html. Requires Edge or Chrome. Falls back to HTML if no browser is found.

Extrahiert Text aus Bildern (JPG/PNG/BMP/TIFF) mittels OCR (Tesseract).

Erstellt, entpackt und listet ZIP-Archive.

Berechnet Prüfsummen (MD5/SHA1/SHA256/SHA512) für Dateien.

Aktiviert/deaktiviert den Safe Mode. Wenn aktiv, werden alle Löschoperationen (fc_delete_file, fc_delete_directory) über den Papierkorb umgeleitet.

Set the output language for FileCommander tools