{
  "examples": [
    {
      "title": "Understanding CleverAgents CLI Version, Info, and Diagnostics Commands",
      "category": "cli-tools",
      "path": "cli-tools/cli-version-info-diagnostics.md",
      "feature": "Version info diagnostics fast-path regular initialization",
      "commands": [
        "agents version",
        "agents info",
        "agents diagnostics",
        "agents --format json version",
        "agents --format json info",
        "agents --format json diagnostics",
        "agents --format yaml version",
        "agents --format yaml info",
        "agents --format yaml diagnostics"
      ],
      "complexity": "beginner",
      "educational_value": "high",
      "generated_by": "uat-tester",
      "generated_at": "2026-04-19"
    },
    {
      "title": "Mastering Output Format Flags in CleverAgents CLI",
      "category": "cli-tools",
      "path": "cli-tools/output-format-flags.md",
      "feature": "Output formats JSON YAML plain",
      "commands": [
        "agents --format json version",
        "agents --format yaml version",
        "agents --format plain version",
        "agents -f json version",
        "agents --format json info",
        "agents --format json diagnostics",
        "agents -f json actor list",
        "agents -f yaml actor list",
        "agents -f plain actor list"
      ],
      "complexity": "intermediate",
      "educational_value": "high",
      "generated_by": "uat-tester",
      "generated_at": "2026-04-07"
    },
    {
      "title": "REPL and Actor Run: Interactive AI Sessions from the Terminal",
      "category": "cli-tools",
      "path": "cli-tools/repl-and-actor-run.md",
      "feature": "Interactive REPL and single-shot actor run commands",
      "commands": [
        "agents repl",
        "agents repl --help",
        "agents actor run",
        "agents actor run openai/gpt-4o \"Say hello\"",
        "agents actor run --help",
        "agents actor run local/demo-assistant \"What is the capital of France?\" --config my-assistant.yaml",
        "agents actor run local/demo-assistant \"What is the capital of France?\" --config my-assistant.yaml --output answer.txt",
        "agents actor run local/demo-assistant \"Write a haiku about mountains\" --config my-assistant.yaml --temperature 0.9",
        "agents actor run local/demo-assistant \"I'm working on a Python project\" --config my-assistant.yaml --context my-session --context-dir /tmp/my-contexts",
        "agents actor run local/demo-assistant \"What are best practices for error handling?\" --config my-assistant.yaml --context my-session --context-dir /tmp/my-contexts"
      ],
      "complexity": "intermediate",
      "educational_value": "high",
      "generated_by": "uat-tester",
      "generated_at": "2026-04-07"
    },
    {
      "title": "Managing AI Actors with the CleverAgents CLI",
      "category": "cli-tools",
      "path": "cli-tools/actor-management-workflow.md",
      "feature": "Actor management workflows",
      "commands": [
        "agents actor --help",
        "agents actor list",
        "agents actor list --format json",
        "agents actor list --format yaml",
        "agents actor show openai/gpt-4o",
        "agents actor show anthropic/claude-sonnet-4-20250514",
        "agents actor show openai/gpt-4o --format json",
        "agents actor add local/my-haiku-actor --config my-haiku-actor.yaml",
        "agents actor add local/my-haiku-actor --config my-haiku-actor.yaml --format json",
        "agents actor set-default local/my-haiku-actor",
        "agents actor set-default anthropic/claude-sonnet-4-20250514",
        "agents actor update local/my-haiku-actor --option temperature=0.7",
        "agents actor set-default openai/gpt-4o",
        "agents actor remove local/my-haiku-actor"
      ],
      "complexity": "intermediate",
      "educational_value": "high",
      "generated_by": "uat-tester",
      "generated_at": "2026-04-07"
    },
    {
      "title": "Server Connection and A2A Protocol Integration",
      "category": "cli-tools",
      "path": "cli-tools/server-and-a2a-integration.md",
      "feature": "Server and A2A integration",
      "commands": [
        "agents server --help",
        "agents server status",
        "agents server status --format json",
        "agents server connect https://agents.example.com",
        "agents server connect https://agents.example.com --format json",
        "agents server connect https://agents.example.com --namespace my-team --format json",
        "agents server connect http://localhost:8080 --no-tls-verify --format json",
        "agents server status --format yaml",
        "agents server status --format plain",
        "agents server serve --help"
      ],
      "complexity": "advanced",
      "educational_value": "high",
      "generated_by": "uat-tester",
      "generated_at": "2026-04-07"
    },
    {
      "title": "Audit Log & Security: Tracking Every Security-Relevant Operation",
      "category": "cli-tools",
      "path": "cli-tools/audit-log-and-security.md",
      "feature": "Audit log management and security tracking",
      "commands": [
        "agents audit list",
        "agents audit list --plan plan-abc123",
        "agents audit list --type plan_applied",
        "agents audit list --project data-pipeline",
        "agents audit list --limit 3",
        "agents audit list --since 2026-03-31T14:43:41",
        "agents audit show 1",
        "agents audit show 2",
        "agents audit show 99999",
        "agents audit count",
        "agents audit prune --days 30 --yes",
        "agents audit prune --days 30",
        "agents audit prune --days 0",
        "agents audit --help",
        "agents audit list --help",
        "agents audit show --help",
        "agents audit prune --help"
      ],
      "complexity": "intermediate",
      "educational_value": "high",
      "generated_by": "uat-tester",
      "generated_at": "2026-04-07"
    },
    {
      "title": "Managing Tools and Validations in CleverAgents",
      "category": "cli-tools",
      "path": "cli-tools/tool-and-validation-management.md",
      "feature": "Tool and validation management",
      "commands": [
        "agents tool add --config examples/tools/custom-tool.yaml",
        "agents validation add --config examples/validations/required-validation.yaml",
        "agents validation add --config examples/validations/wrapped-validation.yaml",
        "agents tool list",
        "agents tool list --type validation",
        "agents tool list --type tool",
        "agents tool list --namespace qa",
        "agents tool show local/line-counter",
        "agents tool show qa/coverage-check",
        "agents tool list --format json",
        "agents tool show local/line-counter --format json",
        "agents validation add --config examples/validations/required-validation.yaml --update",
        "agents tool remove --yes local/line-counter"
      ],
      "complexity": "intermediate",
      "educational_value": "high",
      "generated_by": "uat-tester",
      "generated_at": "2026-04-07"
    }
  ],
  "categories": {
    "cli-tools": {
      "name": "CLI Tools",
      "description": "Text-based command-line applications",
      "keywords": [
        "CLI",
        "command-line",
        "terminal",
        "console",
        "tool"
      ]
    },
    "api-clients": {
      "name": "API Clients",
      "description": "Command-line clients for web APIs",
      "keywords": [
        "API",
        "REST",
        "client",
        "HTTP",
        "web",
        "request"
      ]
    },
    "data-processing": {
      "name": "Data Processing",
      "description": "Tools for data analysis and transformation",
      "keywords": [
        "data",
        "CSV",
        "JSON",
        "parser",
        "analyzer",
        "transform"
      ]
    },
    "testing-tools": {
      "name": "Testing Tools",
      "description": "Testing utilities and automation",
      "keywords": [
        "test",
        "pytest",
        "behave",
        "unittest",
        "automation",
        "QA"
      ]
    }
  },
  "last_updated": "2026-04-27"
}
