sshfs-mount-plugin

SSHFS Mount Manager

A universal SSHFS remote mount management tool, designed for Claude Code Plugin.

Features

• 🔧 Universal Configuration - Support for any number of remote hosts with independent configurations
• 📋 Profile Management - Multiple configuration sets for different scenarios (work/personal)
• 🔄 Daemon Process - Automatic detection and reconnection for dropped mounts
• 🤖 Claude Code Integration - Convenient mount management via Plugin/Skills
• 📝 Auto CLAUDE.md Generation - Automatically generate usage documentation for remote directories

Project Structure (v2.0 - Plugin Architecture)

sshfs-mount/
├── plugins/
│   └── sshfs-mount/               # Plugin main directory
│       ├── .claude-plugin/
│       │   └── plugin.json        # Plugin manifest file
│       ├── skills/
│       │   └── sshfs-mount.skill.md  # Skill definition
│       ├── commands/
│       │   ├── sshfs-status.md       # /sshfs-status status check
│       │   ├── sshfs-mount-all.md    # /sshfs-mount-all mount all
│       │   ├── sshfs-unmount-all.md  # /sshfs-unmount-all unmount all
│       │   ├── sshfs-mount-project.md    # /sshfs-mount-project mount specific remote
│       │   ├── sshfs-unmount-project.md  # /sshfs-unmount-project unmount specific remote
│       │   ├── sshfs-daemon.md       # /sshfs-daemon daemon management
│       │   └── sshfs-generate-claude-md.md  # /sshfs-generate-claude-md generate CLAUDE.md
│       ├── lib/
│       │   ├── sshfs_mount.py        # Core logic (config management, mount/unmount)
│       │   ├── sshfs_daemon.py       # Daemon process (auto-reconnect)
│       │   └── generate_claude_md.py # CLAUDE.md generator
│       ├── bin/
│       │   ├── sshfs-mount           # CLI entry point
│       │   ├── sshfs-daemon          # Daemon entry point
│       │   └── sshfs                 # Quick mount script
│       └── scripts/
│           ├── install.sh            # Installation script
│           └── create-package.sh     # Packaging script
├── .claude/
│   └── settings.local.json          # Claude Code local settings
├── CHANGELOG.md                     # Changelog
└── README.md                        # This file (English)

Quick Start

Installation

Option 1: Install via Claude Code (Recommended)

# Run in Claude Code
/plugin marketplace add Mowenhao13/sshfs-mount-plugin
/plugin install sshfs-mount@sshfs-mount-plugin

Option 2: Run Installation Script (Standalone CLI)

# Clone or download the project
cd sshfs-mount/plugins/sshfs-mount

# Run installation script
./scripts/install.sh

After installation, global commands are created:

• sshfs-mount - Main CLI tool
• sshfs-daemon - Daemon management

First Time Usage

# Run initialization wizard
sshfs-mount init

The initialization will:

1. Create config directory ~/.config/sshfs-mount-plugin/
2. Run interactive wizard to configure remote hosts
3. Parse existing SSH config for auto-fill

Basic Commands

# Check mount status
sshfs-mount status

# Mount all remote directories
sshfs-mount mount

# Mount a specific remote directory
sshfs-mount mount <remote-name>

# Unmount all remote directories
sshfs-mount unmount

# Unmount a specific remote directory
sshfs-mount unmount <remote-name>

# Start daemon (auto-reconnect)
sshfs-daemon start

# Check daemon status
sshfs-daemon status

Claude Code Plugin Integration

After installing the plugin, restart Claude Code to use the following features:

Commands

Command	Function
/sshfs-status	Check mount status of all remote directories
/sshfs-mount-all	Mount all remote directories
/sshfs-unmount-all	Unmount all remote directories
/sshfs-mount-project <name>	Mount a specific remote directory by name
/sshfs-unmount-project <name>	Unmount a specific remote directory by name
/sshfs-daemon start	Start daemon process
/sshfs-daemon stop	Stop daemon process
/sshfs-daemon status	Check daemon status
/sshfs-generate-claude-md	Generate CLAUDE.md for mounted directories

Skill

Use /sshfs-mount skill for interactive operations including:

• Mount/unmount remote directories
• Daemon management
• Profile switching
• Configuration management

Configuration Files

File Locations

• Main Config: ~/.config/sshfs-mount-plugin/config.yaml
• Profiles: ~/.config/sshfs-mount-plugin/profiles/
• Daemon Log: ~/.config/sshfs-mount-plugin/daemon.log

Configuration Format

local_root: ~/projects