# Octofs

Gives AI coding assistants direct filesystem and remote SSH access. Enables content searching, atomic batch file editing, and command execution.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18
- Author: Muvon
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Muvon/octofs
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/octofs

## What it does

Octofs is a standalone Rust binary built on `tokio` and `axum`. It equips agents with tools to inspect directory trees while respecting `.gitignore` rules, locate snippets using context-aware search, and read files in chunks. It also handles remote targets directly via `ssh://` URLs.

File modifications rely on composite `N:hh` line identifiers verified against hashes at write time. If external changes occur beforehand, the server rejects outdated edits and suggests relocation offsets. The tool handles atomic batch modifications and stores up to 10 undo steps per file in memory.

Building from source requires Rust 1.95 or later. In practice, you do not need the Rust compiler because pre-compiled binaries and an npm wrapper handle execution automatically.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add octofs -- npx -y @muvon/octofs
```

### Codex

**Platform CLI**
```bash
codex mcp add octofs -- npx -y @muvon/octofs
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "octofs": {
            "command": "npx",
            "args": [
                "-y",
                "@muvon/octofs"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "octofs": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@muvon/octofs"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add octofs npx -y @muvon/octofs
```

## When to use it
- Search codebase text with surrounding context lines
- Modify remote files directly using `ssh://` paths
- Apply atomic multi-line batch edits to a single file
- Block conflicting writes via line-hash validation

## Example prompts
- Find all occurrences of unwrap() in this repository and display their context
- Generate a test.rs file with basic unit tests
- Inspect the directory structure at ssh://user@server:22/var/www

## Similar
- [termcp](https://affpapa.org/en/nevibecode/mcp/termcp.md) — MCP server · ★ 59
- [agent-tool](https://affpapa.org/en/nevibecode/mcp/agent-tool.md) — MCP server · ★ 24
- [sshmcp](https://affpapa.org/en/nevibecode/mcp/sshmcp.md) — MCP server · ★ 11
- [ssh](https://affpapa.org/en/nevibecode/mcp/ssh.md) — MCP server · ★ 81
- [system-info](https://affpapa.org/en/nevibecode/skills/system-info.md) — skill · 302 installs
- [Remote Desktop Commander](https://affpapa.org/en/nevibecode/mcp/remote-desktop-commander.md) — MCP server · ★ 194

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md