CSEMA Labs CLI

The official Command Line Interface for managing, provisioning, and starting CSEMA Labs directly from your terminal.

Installation

Install the package globally using npm:

npm install -g csema-cli

Note: You must have Oracle VirtualBox 7.x installed on your system.

Usage

Once installed, the csema command will be available anywhere in your terminal.

1. Check System Status

Verify that your CLI and VirtualBox are configured correctly.

csema status

2. Login

Authenticate with your CSEMA platform account. You will be prompted to enter your email and an OTP sent to your inbox.

csema login

3. List Labs

View all machine challenges available to your account tier.

csema list

4. Interactive Dashboard

Want to avoid typing commands? Open the fully interactive dashboard to manage your labs using your arrow keys!

csema ui

5. Check Local Machine Status

See exactly which labs are currently installed on your computer and whether they are running or stopped.

csema active

6. Setup a Machine

Download and import a specific lab into VirtualBox. (Find the ID using csema list).

csema setup <lab-id>

7. Start/Stop a Machine

# Boot up the machine
csema start <lab-id>

# Shut it down safely
csema stop <lab-id>

8. Delete a Machine

Remove the machine entirely from your system to free up disk space.

csema delete <lab-id>

9. Network settings (VirtualBox)

See how each NIC is attached (NAT, bridged, host-only) and change it without opening VirtualBox Manager. Bridged puts the VM on your LAN (you pick the host interface). Host-only isolates traffic to the host ↔ VM (typical names: vboxnet0). Most changes require the VM to be powered off; the CLI will offer to stop it first.

# Show adapters for the VM that belongs to this lab
csema network show <lab-id>

# Interactive wizard (slot, mode, bridge/host-only lists)
csema network set <lab-id>

# Scriptable example: NIC 1 bridged to Wi‑Fi / Ethernet (name from `VBoxManage list bridgedifs`)
csema network set <lab-id> --slot 1 --mode bridged --bridge-adapter "Intel(R) Wi-Fi 6 AX201" -y

# Host-only
csema network set <lab-id> --slot 1 --mode hostonly --hostonly-adapter vboxnet0 -y

In csema ui, choose Network settings (NAT / bridged / host-only) after selecting an installed lab.

Features

• Interactive TUI: Fully interactive terminal UI for navigating and managing labs.
• Network control: Switch NICs between NAT, bridged, and host-only from the CLI or the interactive UI.
• 1-Click Provisioning: Automatically downloads .rar archives and extracts the .ova lab seamlessly.
• Auto-Discovery & Live Status: Locates your VirtualBox installation dynamically and tracks VM state in real-time.
• Auto-Updates: Automatically notifies you when a new version of the CLI is published.
• Secure: Uses stateless OTP-based authentication via the CSEMA API with strict file permissions.