Start here
Command line
Install Progrid on your computer and manage everything from the terminal.
The prgd command is a single binary for Linux, macOS and Windows with no dependencies.
Install
curl -fsSL https://get.progrid.sa | sh
On Windows, download the zip from the releases page and put prgd.exe on your PATH.
Sign in
prgd login
Enter your email and password. If two factor sign in is on, you are asked for the code from your authenticator app. The session is saved in ~/.config/prgd/config.json. You can also paste an API token instead of an email to use that token.
Your first server
prgd servers create web-1 --size s-1vcpu-1gb --image ubuntu-24-04 --wait
prgd servers ls
prgd ssh web-1
--wait blocks until the server is active and prints its address. Every create call sends an idempotency key, so a retried command never makes two servers.
Everyday commands
| Task | Command |
|---|---|
| List sizes with prices | prgd sizes |
| List images and one click apps | prgd images |
| Stop, start, reboot | prgd servers stop web-1, start, reboot |
| Resize | prgd servers resize web-1 --size s-2vcpu-4gb |
| Take a snapshot | prgd servers snapshot web-1 |
| Delete | prgd servers delete web-1 |
| Deploy a repository | prgd deploy https://github.com/you/app --branch main |
| See spend | prgd billing |
| Create an agent token | prgd tokens create claude --agent --cap 15 |
| Review agent requests | prgd approvals ls, approve ID, deny ID --reason TEXT |
Add --json to any command to get the raw API response, which is handy in scripts:
prgd servers ls --json | jq -r '.data[] | select(.status=="active") | .networks.v4[0].ipAddress'
Scripting and CI
In CI, set PRGD_TOKEN to an API token and PRGD_API_URL if you use a different endpoint. The CLI reads those before the config file, so no login step is needed.
- run: curl -fsSL https://get.progrid.sa | sh
- run: prgd deploy https://github.com/${{ github.repository }} --branch ${{ github.ref_name }}
env:
PRGD_TOKEN: ${{ secrets.PRGD_TOKEN }}