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.3.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.3.tar.gz.
File metadata
- Download URL: airgap_file_bridge-1.0.3.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 |
a8b14ad17f9a2db8070daede7063832516a1089815a836fb2209e5e49ec10c4e
|
|
| MD5 |
7b44fc31a0556a3a3189860ba6a24f6e
|
|
| BLAKE2b-256 |
b0cf4b76c767957643310a131f3e672e8d822a8092a9cfa65535b26cecbd4252
|
Provenance
The following attestation bundles were made for airgap_file_bridge-1.0.3.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.3.tar.gz -
Subject digest:
a8b14ad17f9a2db8070daede7063832516a1089815a836fb2209e5e49ec10c4e - Sigstore transparency entry: 2682126569
- Sigstore integration time:
-
Permalink:
Airgap-fleet/file-bridge@b15f8b7e269f63bd1d572ab96842bbbba2e3d192 -
Branch / Tag:
refs/tags/v1.0.3 - Owner: https://github.com/Airgap-fleet
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@b15f8b7e269f63bd1d572ab96842bbbba2e3d192 -
Trigger Event:
push
-
Statement type:
File details
Details for the file airgap_file_bridge-1.0.3-py3-none-any.whl.
File metadata
- Download URL: airgap_file_bridge-1.0.3-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 |
45a28f3c91165ecc1575cd9a17bfeaa6258fc2937a6bc4b25b4eadc6092a025d
|
|
| MD5 |
609a62edcb8b7e6da67c390543190683
|
|
| BLAKE2b-256 |
f5a96a9dbefa495364129447e2cede8b41f94960bf98a2e8d8d9ed7c13caa54a
|
Provenance
The following attestation bundles were made for airgap_file_bridge-1.0.3-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.3-py3-none-any.whl -
Subject digest:
45a28f3c91165ecc1575cd9a17bfeaa6258fc2937a6bc4b25b4eadc6092a025d - Sigstore transparency entry: 2682126617
- Sigstore integration time:
-
Permalink:
Airgap-fleet/file-bridge@b15f8b7e269f63bd1d572ab96842bbbba2e3d192 -
Branch / Tag:
refs/tags/v1.0.3 - Owner: https://github.com/Airgap-fleet
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@b15f8b7e269f63bd1d572ab96842bbbba2e3d192 -
Trigger Event:
push
-
Statement type:
