First job

Submit from a client after the queue host is up (Prepare). Also see User Guide · submit, status, Where files live.

Point at the queue host

Run from a directory where Queue is loadable (julia --project=.). That --project=. stays on the client. The hop loads Queue from ~/.distsshkitqueue/env (--queue-env DIR if you used another dir). SCRIPT.jl must exist on the queue host in that job's clone (~/org/Repo.jl), not only on the laptop. Hop does not send the client cwd.

julia --project=. -m DistSSHKitQueue qhost:mini list-host
julia --project=. -m DistSSHKitQueue qhost:mini size

One lab: export DISTSSHKITQUEUE_HOST=mini and omit qhost: (the token still wins). Several clusters: pass qhost: each time.

list-host is not Kit --hosts. ssh -G runs on the queue host. size is DistSSHKit size there (does not enqueue).

Submit

Kit argv is DistSSHKit's (go child:NAME:N SCRIPT.jl, or parent:N when workers are on the queue host). Flags: kit go, kit drive.

julia --project=. -m DistSSHKitQueue qhost:mini submit go child:host1:4 SCRIPT.jl
julia --project=. -m DistSSHKitQueue qhost:mini status
julia --project=. -m DistSSHKitQueue qhost:mini watch
julia --project=. -m DistSSHKitQueue qhost:mini cancel <id>

submit starts a waiter if none is running. status / watch print qhost (or local (hostname) when you omitted it). watch redraws until Ctrl-C; it does not stop the waiter. Job ids print as a bare stdout line. submit also prints Queued N on stderr unless DISTSSHKIT_QUIET is set.

Bare go / drive alias submit go / submit drive. A Kit-shaped line with a .jl and no Queue verb is go.

There is no --via. Do not pass qhost: to setup / serve / enable / disable / add-host / remove-host.

Next: User Guide.