synology-manager

A Claude Code plugin for managing a Synology NAS. Provides guided first-run setup, persistent context across sessions, and SSH-based administration commands for shared folders, volumes, mounts, and storage monitoring.

What It Does

• Interactively gathers your NAS connection details and persists them to context files
• Tests SSH connectivity and discovers hardware/software configuration automatically
• Provides slash commands for common NAS operations (status checks, share listing, mount management)
• Maintains a workspace context that makes each Claude Code session NAS-aware from the start

Commands

Command	Description
/first-run	Interactive intake wizard — gathers NAS IP, SSH credentials, authorized operations, and populates all context files
/nas-status	Query current disk usage, RAID status, and running services; refreshes context/storage-report.md
/list-shares	List all shared folders on the NAS and refresh volume snapshots in context
/manage-mounts	View, add, or remove NFS/SAMBA mounts between the local machine and the NAS

Agents

Agent	Description
synology-intake	Subagent invoked by /first-run — handles interactive setup, SSH connectivity testing, NAS discovery, and context population

Requirements

• SSH access to your Synology NAS (DSM Control Panel > Terminal & SNMP > Enable SSH service), or
• A Synology MCP server configured in Claude Code

Installation

claude plugin install danielrosehill/synology-manager-plugin

Or add it to your project's .claude/plugins.json:

{
  "plugins": [
    {
      "name": "synology-manager",
      "source": {
        "type": "github",
        "repo": "danielrosehill/synology-manager-plugin"
      }
    }
  ]
}

Usage

1. Open this plugin directory as your Claude Code project workspace.
2. Run /first-run — the intake agent will walk you through setup interactively.
3. Once configured, use the commands above or ask Claude naturally:
   • "Show me all shared folders on the NAS"
   • "How much disk space is left?"
   • "Mount the media share to ~/nas-media"
   • "What is the RAID status?"
   • "Sync my documents folder to the NAS"

Directory Structure

.
├── CLAUDE.md                      # Workspace context (populated by /first-run)
├── README.md                      # This file
├── commands/
│   ├── first-run.md               # Guided setup command
│   ├── nas-status.md              # Storage and service status
│   ├── list-shares.md             # Shared folder listing
│   └── manage-mounts.md           # Mount management
├── agents/
│   └── synology-intake.md         # Setup subagent
└── context/
    ├── nas-profile.md             # NAS hardware/network details (auto-populated)
    ├── storage-report.md          # Latest storage utilization (auto-updated)
    ├── volumes/                   # Periodic volume snapshots
    └── mounts/                    # Mount configuration records

License

MIT — Daniel Rosehill