File Bridge
Bridge your AI assistant to local files — read, write, search, and manage files securely without cloud dependencies.
Quick Start (uvx — no install needed)
uvx airgap-file-bridge /path/to/your/files
Installation
pip install airgap-file-bridge
Usage
CLI (Direct)
airgap-file-bridge
MCP Client Config (Claude Desktop, Cursor, VS Code)
{
"mcpServers": {
"files": {
"command": "airgap-file-bridge",
"env": {
"FILE_BRIDGE_ROOT_PATH": "C:/path/to/files"
}
}
}
}
DXT (Claude Desktop 1-Click)
Download airgap-file-bridge-1.0.2.dxt from Releases → drag into Claude Desktop.
Configuration
| Environment Variable | Default | Description |
|---|---|---|
FILE_BRIDGE_ROOT_PATH |
Current directory | Root directory for file operations |
FILE_BRIDGE_MAX_FILE_SIZE |
10MB | Max file size for operations |
FILE_BRIDGE_FOLLOW_SYMLINKS |
false | Follow symlinks |
FILE_BRIDGE_ALLOW_ABSOLUTE_PATHS |
false | Allow absolute paths outside root |
FILE_BRIDGE_DEFAULT_ENCODING |
utf-8 | Text encoding |
Available Tools
| Tool | Description |
|---|---|
read_file |
Read a file safely with size limits and binary detection |
write_file |
Write a file atomically with size limits |
list_dir |
List directory contents with optional filtering and recursion |
search_files |
Search file contents using ripgrep |
glob |
Find files matching a glob pattern |
patch_file |
Apply a targeted patch to a file (find and replace) |
Transport Modes
- stdio (default) — For local MCP clients (Claude Desktop, etc.)
- sse — Server-Sent Events for HTTP clients
- http — Streamable HTTP for modern clients
Set via FILE_BRIDGE_TRANSPORT environment variable.
Why File Bridge?
- Local-first — Your files never leave your machine
- Air-gapped ready — No cloud dependencies, works offline
- Security hardened — Path traversal protection, size limits, symlink control, binary detection
- Multiple transports — stdio, SSE, Streamable HTTP
- Ripgrep powered — Fast regex search with context
- uvx compatible — Zero-install usage like the competition
Development
# Install with dev dependencies
pip install -e ".[dev]"
# Run tests
uv run pytest -v
# Check code quality
uv run ruff check .
uv run mypy .
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
airgap_file_bridge-1.0.4.tar.gz
(15.3 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file airgap_file_bridge-1.0.4.tar.gz.
File metadata
- Download URL: airgap_file_bridge-1.0.4.tar.gz
- Upload date:
- Size: 15.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3370dc55505a52bb14ce036f3a57bb6fcca26d3fd93f0fc33089bf6e8fd25453
|
|
| MD5 |
d88a7ca23525f1ab528b7b675ff17c7c
|
|
| BLAKE2b-256 |
5788e8789b6fd382c6456844c229ebb4de0d015abad92b5746ff089a4fa7a5ad
|
Provenance
The following attestation bundles were made for airgap_file_bridge-1.0.4.tar.gz:
Publisher:
ci.yml on Airgap-fleet/file-bridge
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
airgap_file_bridge-1.0.4.tar.gz -
Subject digest:
3370dc55505a52bb14ce036f3a57bb6fcca26d3fd93f0fc33089bf6e8fd25453 - Sigstore transparency entry: 2682493511
- Sigstore integration time:
-
Permalink:
Airgap-fleet/file-bridge@7f1711537b6ad1ac2235b92b6ac0a6b0f9e39de4 -
Branch / Tag:
refs/tags/v1.0.4 - Owner: https://github.com/Airgap-fleet
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@7f1711537b6ad1ac2235b92b6ac0a6b0f9e39de4 -
Trigger Event:
push
-
Statement type:
File details
Details for the file airgap_file_bridge-1.0.4-py3-none-any.whl.
File metadata
- Download URL: airgap_file_bridge-1.0.4-py3-none-any.whl
- Upload date:
- Size: 12.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0706f364a324f7f3af8ae0ac1efbe17526d88e5a68f39587e40810552f1ab296
|
|
| MD5 |
4c2dbe2c92d5160c61191133ab70d48e
|
|
| BLAKE2b-256 |
656151a91ecde052f426cb59be5f4c79edcc9c907bdedead65f8115d36b5aba6
|
Provenance
The following attestation bundles were made for airgap_file_bridge-1.0.4-py3-none-any.whl:
Publisher:
ci.yml on Airgap-fleet/file-bridge
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
airgap_file_bridge-1.0.4-py3-none-any.whl -
Subject digest:
0706f364a324f7f3af8ae0ac1efbe17526d88e5a68f39587e40810552f1ab296 - Sigstore transparency entry: 2682493556
- Sigstore integration time:
-
Permalink:
Airgap-fleet/file-bridge@7f1711537b6ad1ac2235b92b6ac0a6b0f9e39de4 -
Branch / Tag:
refs/tags/v1.0.4 - Owner: https://github.com/Airgap-fleet
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@7f1711537b6ad1ac2235b92b6ac0a6b0f9e39de4 -
Trigger Event:
push
-
Statement type:
