remote-admin

Remote Admin Plugin for Claude Code

Manage remote hosts from Claude Code via a lightweight SSH bridge service. Connect to any SSH-accessible machine, run commands, stream an interactive shell, and install Hive Mind on new nodes — all without leaving your Claude session.

Install

/plugin install danielstewart77/remote-admin-claude-plugin

Prerequisites

• Docker (to run the bridge service)
• REMOTE_ADMIN_TOKEN set in your .env
• jq and curl available in the Claude Code environment

Quick Start

1. Start the bridge service:

   docker compose up -d remote-admin
   

2. Store your token in the keyring:

   /secrets set remote_admin_token <your-token>
   

3. Connect to a remote host:

   /remote-admin connect 192.168.1.50 pi
   

4. To set up a brand-new machine (Docker + Hive Mind):

   /setup-remote 192.168.1.50 --standalone
   

Skills

Skill	Description
/remote-admin	SSH session management — connect, exec, list, close, interactive shell
/setup-remote	Install Hive Mind on a remote host — key enrollment, prerequisites, Docker, deploy

Service API

The bridge (services/remote_admin.py) runs on port 8430:

Method	Path	Description
POST	/sessions	Open SSH session (key or password auth)
GET	/sessions	List active sessions
GET	/sessions/{id}	Session detail
DELETE	/sessions/{id}	Close session
POST	/sessions/{id}/exec	Run command, return stdout/stderr/exit_code
WS	/sessions/{id}/stream	Interactive shell (xterm)

Credential Storage

SSH keys are stored in the system keyring per-user by Telegram user ID:

• remote_admin_ssh_key_<TID> — ed25519 private key
• remote_admin_sudo_<host_underscored> — optional sudo password per host

See docs/remote-install.md for the full installation guide.