shpool-remote

Manage shpool sessions on remote hosts.

Usage

# List all sessions on a host
shpool-remote <host> list

# Detach a session (keeps it running)
shpool-remote <host> detach <session>

# Kill a session (terminates it)
shpool-remote <host> kill <session>

# Attach to a session (interactive)
shpool-remote <host> attach <session>

Examples

# List all sessions on rhea
shpool-remote rhea.home list

# Detach the "dev" session on rhea
shpool-remote rhea.home detach dev

# Kill an old session
shpool-remote rhea.home kill old-work

# Attach to a session (uses SSH shpool-ssh-wrapper integration)
shpool-remote rhea.home attach myproject

How it works

This tool is a thin wrapper around shpool commands executed over SSH. It simplifies managing remote shpool sessions without having to manually construct SSH commands.

For the attach command, it uses the SSH host/session pattern which integrates with shpool-ssh-wrapper from your SSH config.

Building

# Build with Nix
nix build .#shpool-remote

# Or build with Go
cd tools/shpool-remote
go build

Installation

The package is available in the flake outputs:

home.packages = with pkgs; [
  shpool-remote
];