Product

LoadForge CLI

Easy command line automation

Run load tests via your CLI

Included with all accounts
All LoadForge users can use the LoadForge CLI helper to run tests, get results, and more.
Built for automated testing
Easily launch tests and view their live results, and historical results for completed tests.
Host Health via API
Check your host latency and health via the API as well.
Token based authentication
Create multiple tokens allowing certain CLI users read only access, and others the ability to execute tests.
# Install LoadForge CLI
❯ composer global require adventdevinc/loadforge-cli

# Save your api key
❯ echo "MY_API_KEY_STRING" > ~/.loadforge-api-key

# List tests
❯ lf-cli tests:list
+-----+-----------------+--------+------+---------+--------+
| ID  | Name            | Users  | Rate | Servers | Region |
+-----+-----------------+--------+------+---------+--------+
| 563 | Blog            | 50     | 1    | 1       | nyc3   |
| 332 | Advent Strapi   | 300000 | 1    | 10      | sfo3   |
| 318 | LoadForge Blog  | 50     | 10   | 1       | nyc3   |
+-----+-----------------+--------+------+---------+--------+

# Run test
❯ lf-cli tests:run 682 5
Running test 682 for 5 minutes.

Run launched with ID: 3634
You may run the following command to monitor it:
lf-cli results:get 3634
                

Ready to install? Visit our GitHub repo for more detailed instructions.