Shu-Wan/solx

☀️ solx

Solx is a CLI for ASU's Sol supercomputer, designed for agent-assisted work so you can stop babysitting Slurm.

• No memorizing SLURM commands.
• No surprise /scratch purges.
• Let your agent manage your SLURM jobs.

SSH to Sol, run solx, and keep the whole loop in your terminal.

Installation

On Sol — solx provisions its own Python (≥ 3.10) via uv:

curl -fsSL https://github.com/Shu-Wan/solx/releases/latest/download/install.sh | sh

Re-run that command to upgrade. Prefer a package manager?

uv tool install git+https://github.com/Shu-Wan/solx.git#subdirectory=solx

Both channels need uv on your $PATH — install it from astral.sh/uv first if you don't have it.

Usage

solx init                 # one-time: write ~/.config/solx/config.toml
solx config edit          # define your job templates + [keep] paths
solx job start gpu        # request an interactive allocation (waits for the grant)
solx job jump             # open a shell on the compute node
solx keep                 # renew /scratch files Sol has flagged for deletion

What it's good at:

• Interactive jobs from templates. Define [jobs.gpu] once, then solx job start gpu allocates and waits and solx job jump drops you onto the node. Cancel with solx job stop (or raw scancel).
• Keeping /scratch alive. Sol purges inactive files on a schedule; solx keep renews only the directorie