CLI

Examples

Real-world TLD CLI usage patterns.

Daily workflow

bash
# Start your session
$ tld doctor # verify environment
$ tld lab list --track docker
 
# Pick a lab and work on it
$ tld lab start dkr-container-networking
# ... investigate and fix ...
$ tld check # validate your fix
 
# Clean up
$ tld lab stop

Scripting with --json

bash
# Get lab list as JSON
$ tld lab list --json | jq '.[] | select(.difficulty == "beginner")'
 
# Get check results as JSON
$ tld check --json | jq '.checks[] | select(.passed == false)'

Usage in CI

yaml
# Example GitHub Actions step
- name: Validate TLD lab
run: |
tld check --json --no-color
env:
TLD_AUTH_TOKEN: ${{ secrets.TLD_TOKEN }}