ludus-cli

Original：🇺🇸 English

Translated

Provide Ludus CLI command guidance, flags, and workflows for range lifecycle, template management, testing mode, snapshots, users/groups, and diagnostics. Use when users ask how to run, interpret, or troubleshoot any `ludus` command.

3installs

Sourcebadsectorlabs/ludus-skills

Added on2026-06-27

NPX Install

npx skill4agent add badsectorlabs/ludus-skills ludus-cli

SKILL.md Content

View Translation Comparison →

Ludus CLI Reference

Reference for Ludus CLI command syntax, flags, and workflows. Use this when users need to run CLI commands directly or when the Ludus API is unavailable.

Key Concepts

Command Pattern

ludus COMMAND [SUBCOMMAND] [ARGS] [--FLAGS]

Global Flags (Available on All Commands)

```
--json
```
- Format output as JSON
```
--url string
```
- Server URL (default:
```
https://198.51.100.1:8080
```
)
```
-u, --user string
```
- Impersonate user (admin only)
```
-r, --range string
```
- Target range ID
```
--proxy string
```
- HTTP(S) proxy URL
```
--verbose
```
- Verbose output
```
--verify
```
- Verify HTTPS certificate

All flags can be set via environment variables:

LUDUS_FLAG_NAME

(uppercase).

Common Workflows

Initial Setup:

bash

ludus apikey                    # Store API key
ludus templates list            # Check available templates
ludus range config get example  # Get example config

Deploy a Range:

bash

ludus range config set -f config.yml  # Set config
ludus range deploy                     # Full deploy
ludus range logs -f                    # Watch progress
ludus range status                     # Check status

Testing Mode:

bash

ludus testing start                      # Snapshot + block internet
ludus testing allow -d example.com       # Allow a domain
ludus testing stop                       # Revert snapshots + restore internet

Template Management:

bash

ludus templates add -d ./my-template   # Add template
ludus templates build                   # Build all unbuilt
ludus templates build -n name1,name2   # Build specific
ludus templates logs -f                 # Watch build progress

References

Use
```
references/commands.md
```
for the complete command reference with subcommands, flags, and examples.
Use
```
https://docs.ludus.cloud/docs/cli
```
as the authoritative source for CLI behavior and changes.

ludus-cli

NPX Install

Tags

SKILL.md Content

Ludus CLI Reference

Key Concepts

Command Pattern

Global Flags (Available on All Commands)

Common Workflows

References