WATcloud CLI

Features

Setup & Installation

Requirements: Go 1.23+

Clone the repository:

git clone https://github.com/WATonomous/watcloud-cli.git
cd watcloud-cli

Build:

go build -o watcloud ./cmd/watcloud

Run:

./watcloud quota list

Project Structure

• cmd/ - CLI entrypoints
• internal/ - Command implementations

Commands

watcloud quota

Subcommand	Description
list	Lists all quota usage (disk, memory, CPU).
disk	Shows your disk usage percentage and free space.
cpu	Displays CPU usage percentage.
memory	Shows memory usage statistics.

watcloud docker

Subcommand	Description
start/run	Starts the rootless Docker Daemon.

watcloud subscription <job_id> [email]

Get notified when a SLURM job finishes.

Usage	Description
watcloud subscription <job_id> <email>	Email notification when the job completes
watcloud subscription <job_id> --discord	Discord notification using $WATCLOUD_DISCORD_WEBHOOK
watcloud subscription <job_id> --discord <webhook_url>	Discord notification with an explicit webhook

To avoid pasting your Discord webhook every time, export it from your shell profile (e.g. ~/.bashrc). Anyone who can read the webhook can post to your channel, so keep that file readable only by you:

export WATCLOUD_DISCORD_WEBHOOK=<webhook_url>

To get a webhook URL, in your Discord channel: Edit Channel → Integrations → Webhooks → New Webhook → Copy Webhook URL.

---

For help and usage examples, run:

./watcloud -h
./watcloud quota -h
./watcloud <command> -h