How do I install the Ludus CLI skill?

Run npx skillmds@latest add badsectorlabs/ludus-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ludus CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ludus CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ludus CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ludus CLI?

badsectorlabs (@badsectorlabs) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ludus CLI by badsectorlabs — Agent Skill

Name: Ludus CLI
Author: badsectorlabs

Ludus CLI

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.

badsectorlabs a8190c3 3 files · 12.1 KB Updated Sep 17, 2026

File contents

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:

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

Deploy a Range:

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:

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

Template Management:

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.

---name: ludus-clidescription: 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.---# Ludus CLI ReferenceReference 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 certificateAll flags can be set via environment variables: `LUDUS_FLAG_NAME` (uppercase).### Common Workflows**Initial Setup:**```bashludus apikey # Store API keyludus templates list # Check available templatesludus range config get example # Get example config```**Deploy a Range:**```bashludus range config set -f config.yml # Set configludus range deploy # Full deployludus range logs -f # Watch progressludus range status # Check status```**Testing Mode:**```bashludus testing start # Snapshot + block internetludus testing allow -d example.com # Allow a domainludus testing stop # Revert snapshots + restore internet```**Template Management:**```bashludus templates add -d ./my-template # Add templateludus templates build # Build all unbuiltludus templates build -n name1,name2 # Build specificludus 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.

Frequently asked questions