BACH FileCommander

Shows detailed information about a file/directory. Args: - path (string): Path to the file/directory Returns: - Size, type, creation/modification date, permissions

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

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

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/

Get the active output language and all supported language codes

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

Returns the current system time. Returns: - Date, time, weekday, timezone

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!

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

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)

Lists all active and completed background searches.

Lists all active and ended sessions. Returns: - Table of all sessions with status

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.

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"

Description is built at runtime.

Description is built at runtime.

Description is built at runtime.

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"

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"]

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

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.

Description is built at runtime.

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

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"

Set the output language for FileCommander tools

Description is built at runtime.

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)

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)

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"

Stops a running background search. Args: - search_id (string): Search ID

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=""

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

Description is built at runtime.

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!