FileLoad

---

Claude Code on your server, from anywhere

Coding agents work best next to the code: on the box with the GPUs, the datasets, the full toolchain and a fast network. FileLoad makes that server feel local:

• Type claude in any local terminal. FileLoad's built-in SSH proxy logs you in (no password or key prompts) and starts Claude Code inside the mounted project directory. Run it from a sub-folder of the mount and it starts in the matching remote sub-folder.
• Watch the agent's work live in your own tools. The same directory is mounted locally, so you can browse, diff and review what Claude Code changes in VS Code, Finder or Explorer while it works. Every time a file is opened it is checked against the server, so you always read the agent's latest version.
• Edit alongside it. Your local saves are written back to the server automatically, so you and the agent work on the same files.
• Your laptop is just a window. Code, build and agent all run on the server. Tip: set the remote command to tmux new -As claude claude and the session survives Wi-Fi drops and closed lids.

Works the same for codex, aider, gemini or any other CLI: one custom command each.

flowchart LR
  subgraph Laptop["Your computer"]
    T["Terminal<br/><code>$ claude</code>"]
    E["VS Code / Finder / Explorer<br/>~/FileLoad/my-app  or  Z:\"]
  end
  subgraph FL["FileLoad"]
    P["Local SSH proxy<br/>127.0.0.1:12222"]
    M["Mount + local cache<br/>(write-back upload)"]
  end
  subgraph S["Your server"]
    C["Claude Code<br/>running in /home/dev/my-app"]
    D[("/home/dev/my-app")]
  end
  T --> P -->|"one authenticated SSH connection"| C
  E <--> M <-->|SFTP| D
  C <--> D

Screenshots

The UI is currently in Simplified Chinese; English UI is on the roadmap.

Directory mount	Commands (rcd, claude, codex)

Quick start

1. Install from the latest release:

   OS	File	Notes
   Windows 10/11 x64	FileLoad-Setup-<version>.exe	All-in-one installer: also installs the WinFsp driver if needed
   macOS 13+ (Apple silicon & Intel)	FileLoad-<version>-macos.dmg	Drag to Applications. The app is not notarized: the first time, right-click › Open. FileLoad offers a one-click install of FUSE-T on first mount

2. Connect: enter host, port, user, and a password or private key. Servers are remembered.
3. Pick a remote directory in the built-in browser, e.g. /home/dev/my-app.
4. Mount: pick a drive letter (Windows) or folder (macOS, default ~/FileLoad/<name>). Open it in your editor.
5. Add a command: on the 命令挂载 (Commands) page add name claude, remote command claude (Claude Code must be installed on the server). Open a new terminal and type claude.

The built-in rcd command opens a remote shell that starts in the mounted directory.

Features

• Mount over plain SSH/SFTP: nothing to install on the server. WinFsp on Windows and FUSE-T on macOS (no kernel extension).
• Read cache: a file is downloaded once and then served locally. It is re-validated against the remote size + mtime every time it's opened.
• Write-back: writes land in the local cache and are uploaded by a background queue; pending uploads are flushed on unmount and survive crashes.
• Local commands that run remotely: rcd plus your own commands (claude, codex, make test…). They go through a loopback SSH proxy that reuses FileLoad's authenticated connection: no extra password prompts and no key setup. The command directory is put at the front of PATH, so the commands win over same-named local tools.
• Mount history: re-mount a previous setup with one click.
• Resilient: automatic reconnect and a 15 s keepalive.
• Tray / menu-bar: close the window and keep the mount running.
• One-click auto-update from GitHub Releases: download, install, relaunch.
• Light/dark theme following the system, with Mica on Windows 11.

How it works

Piece	What it does
internal/vfs + cgofuse	FUSE file system served by WinFsp (Windows) or FUSE-T (macOS)
internal/cache	Whole-file read cache plus a dirty-file upload queue; dirty markers survive crashes
internal/backend/sftp	SSH/SFTP client with reconnect, keepalive and a shared connection pool
internal/proxy	Loopback SSH server on 127.0.0.1:12222+ that forwards sessions (PTY included) to the real server
internal/platform	Generates the command wrappers (.cmd/.ps1 or sh) and manages PATH
internal/ui/desktop + frontend/	Wails v3 window; plain HTML/CSS/JS UI with no build step

FAQ

Does anything need to be installed on the server? No, only an SSH server with SFTP enabled (the default for OpenSSH). Install whatever CLI you want to run there (e.g. Claude Code).

Can I pass arguments, like claude --resume? Arguments typed after a local command are not forwarded yet. Add a second command instead, e.g. name claude-resume, remote command claude --resume.

Will I see changes the agent makes right away? A file is checked against the server whenever it's opened, so re-opening or refreshing shows the newest content. Editors that watch files may need focus or a refresh to notice.

Where are my settings and passwords? They stay local: %APPDATA%\fileload on Windows, ~/Library/Application Support/fileload on macOS. Passwords are currently stored in plain text there, so private keys are recommended. Cache, command wrappers and logs live in %LOCALAPPDATA%\fileload or ~/Library/Caches/fileload. Set FILELOAD_HOME=<dir> to keep everything in one folder (portable mode).

Is the local proxy exposed to the network? No. It listens on 127.0.0.1 only, and only while a mount is active.

This is the beginning of the README. Read the rest at the original. Read the full README ↗