Skip to content

remote-workspace.md

Latest commit

 

History

History
69 lines (42 loc) · 2.65 KB

remote-workspace.md

File metadata and controls

69 lines (42 loc) · 2.65 KB
Raw

Remote Workspace

Remote Workspace manages agent-global Skills on SSH hosts. It is a remote management surface, not a local/remote synchronization system.

Host Setup

Add a host from Remote Workspace with:

  • Host name or IP address.
  • SSH port.
  • Username.
  • Password or private key authentication.
  • Optional SSH config import for hosts already defined in your local SSH config.

Connection tests verify the SSH login and detect the remote home directory before scanning Skills.

Credentials

Remote credentials are stored through the operating system credential store. Saving a password is optional. When you edit a host, saved secrets are not shown back in the form; enter a new secret only when you want to replace the stored one.

Scan

Scanning checks the remote agent global Skills directories for supported tools, such as Codex or Claude Code. It does not scan remote project workspaces, arbitrary folders, Git repositories, plugin markets, or ClawHub sources.

The scan result records each detected remote Skill, agent, path, and last scan time.

Install From Skills Center

Use Install to copy a local Skills Center Skill to a selected remote agent global Skills directory. If the target Skill already exists, Remote Workspace creates a remote backup before replacing it.

Update From Skills Center

V1 remote update is conservative: it updates a remote Skill only when there is exactly one enabled local Skills Center Skill with the same name. The existing remote directory is backed up before replacement.

Remote update does not fetch directly from the remote Skill's original Git, plugin, or ClawHub source.

Delete With Backup

Delete removes a selected remote Skill only after creating a backup on the remote host. Backups are stored under:

~/.skills-manager-plus/backups/remote/<host-id>/<agent-id>/<skill-name>/<timestamp>

The operation log records the backup path so you can locate the saved copy later.

Operation Logs

Remote Workspace records install, update, delete, and failure events with operation type, status, timestamp, error message when present, and backup path when a backup was created.

CLI Read-Only Commands

The CLI supports read-only Remote Workspace checks:

smp remote hosts list
smp remote hosts test <host-id-or-name>
smp remote scan <host-id-or-name>
smp remote skills list <host-id-or-name>

These commands use saved host profiles and saved credentials. They do not install, update, or delete remote Skills.

V1 Non-Goals

  • No bidirectional local/remote sync.
  • No remote Project Workspace support.
  • No batch operations across multiple hosts.
  • No direct remote update from Git, plugin markets, or ClawHub.