<div align="center"
🐙 Octofs
Give your AI assistant filesystem superpowers
Standalone Rust binary that exposes filesystem tools over the Model Context Protocol. Built on rmcp 3.x, tokio, and axum.
Installation · Quick Start · Features · Tools Reference · Architecture · Changelog
MCP Registry: io.github.Muvon/octofs
</div
---
Why Octofs?
Your AI coding assistant (Cursor, Claude, Windsurf, etc.) is smart — but it's blind to your filesystem. Octofs bridges that gap, giving your AI:
- Eyes — Read files, search content, explore directories
- Hands — Create, edit, batch-modify files atomically
- Context — Execute commands, manage working directories
- Reach — Transparent SSH/SFTP: every file tool accepts ssh:// URLs
┌─────────────────────────────────────────────────────────────┐
│ You: "Refactor all error handling to use anyhow::Context" │
├─────────────────────────────────────────────────────────────┤
│ AI without Octofs: │
│ • "I can't see your project structure" │
│ • "Please paste the relevant files" │
│ • *Wastes 10 minutes on back-and-forth* │
├─────────────────────────────────────────────────────────────┤
│ AI with Octofs: │
│ • Reads your codebase directly │
│ • Finds all error handling patterns │
│ • Suggests atomic batch edits │└─────────────────────────────────────────────────────────────┘
## What Makes It Different
| Feature | Octofs | Typical Alternatives |
|---------|--------|---------------------|
| **Implementation** | Compiled Rust binary, no runtime | Python/Node script |
| **Content Search** | Built-in search with context lines | String matching only |
| **Batch Operations** | Atomic multi-edit on single file | One-at-a-time |
| **Line Addressing** | Composite `N:hh` ids — hash-verified at apply time; stale edits fail with relocation hints | Number-only |
| **Transport** | STDIO + Streamable HTTP | STDIO only |
| **Shell Integration** | Automatic foreground-to-background handoff | Limited or none |
| **Remote Files** | Transparent SSH/SFTP on every file tool | None || Safety | Gitignore-aware, stale-write detection, path validation | Full filesystem access |
---