Steps to Use Claude with the FileSystem Executable:

  1. Install Claude Desktop

    Download from https://claude.ai/download

  2. Download the Executable

  1. Run the Executable

    1. For macOS users —

      • Run the command below in the terminal (inside the folder)
      chmod +x github
./github

    2. For Windows users:

      • Double-click the file, or
      • Run via terminal: .\\github.exe

  2. Configure Permissions:

    ⚠️ IMPORTANT: Before using this AI Assistant, you must configure file system permissions:

    Note: You must enter complete file/folder paths manually - the interface doesn't support file browsing.

  3. (Optional) Stop the Server:

    You can stop the server if needed.

    Note: This is optional because launching Claude will automatically stop the currently running instance/port.

  4. Launch Claude Desktop

  5. Start Asking Tasks:

    Claude will now recognise the available tools (with descriptions).

🧰 Available Tools

Here is a comprehensive list of available tools, along with their descriptions.

Tool Name Category Description
list-directory Directory List all files and folders within the specified directory
create-directory Directory Creates a new directory at the specified path
delete-directory Directory Deletes a directory
get-allowed-directories Directory Returns the list of allowed directories and their permissions from the configuration
directory-tree Directory Generates a hierarchical tree view of directory structure with customizable depth and filtering options
read-file File Reads file content with line numbers. Supports reading specific line ranges
create-file File Creates a new empty file at the specified path
modify-file File Modifies specific lines in a file without rewriting it. Always get exact line numbers first with read-file
create-excel File Creates an Excel sheet (.xlsx) with specified data and advanced styling
read-excel File Reads Excel (.xlsx) files and returns data from all sheets
create-presentation File Creates a PowerPoint presentation (.pptx) with specified slides and content
read-presentation File Reads PowerPoint (.pptx) files and extracts text content
create-document File Creates a Word document (.docx) with specified content and formatting
read-document File Reads Word (.docx) files and extracts text content
copy-file File Copies a file from the source path to the destination path
delete-file File Deletes a file at the specified path
get-file-directory-info Info Retrieves metadata about a file or directory
search-file-directory Search Searches for files or directories by name within allowed directories
move-rename-file-directory Operations Moves or renames a file or directory from the source path to the destination path
run-shell-command System Executes a shell command on the server. Use carefully, this does not touch the GitHub API, but runs commands in the local environment

Important Notes: