# 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.

- **Type:** Skill
- **Install:** `agentstack add skill-badsectorlabs-ludus-skills-ludus-cli`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [badsectorlabs](https://agentstack.voostack.com/s/badsectorlabs)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [badsectorlabs](https://github.com/badsectorlabs)
- **Source:** https://github.com/badsectorlabs/ludus-skills/tree/main/skills/ludus-cli
- **Website:** https://docs.ludus.cloud/docs/using-ludus/mcp

## Install

```sh
agentstack add skill-badsectorlabs-ludus-skills-ludus-cli
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [badsectorlabs](https://github.com/badsectorlabs)
- **Source:** [badsectorlabs/ludus-skills](https://github.com/badsectorlabs/ludus-skills)
- **License:** MIT
- **Homepage:** https://docs.ludus.cloud/docs/using-ludus/mcp

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-badsectorlabs-ludus-skills-ludus-cli
- Seller: https://agentstack.voostack.com/s/badsectorlabs
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.