Merge pull request #44 from sakamotopaya/feature/cli-usage-examples

feat: implement CLI usage examples system (#19)

Author: ericroliver

examples/README.md

@@ -0,0 +1,85 @@
+# CLI Usage Examples
+
+This directory contains practical examples to help you learn and use the CLI utility effectively.
+
+## 📚 Categories
+
+### 🚀 Basic
+
+Simple commands and fundamental concepts for getting started.
+
+- [Getting Started](basic/getting-started.md) - Your first commands
+- [Help System](basic/help-system.md) - Finding help and documentation
+- [Output Formats](basic/output-formats.md) - Different output formats and their uses
+
+### 🔄 Workflows
+
+Multi-step development workflows and automation patterns.
+
+- [Web Development](workflows/web-development.md) - Complete web development workflow
+- [Code Review](workflows/code-review.md) - Automated code review processes
+- [Project Setup](workflows/project-setup.md) - Setting up new projects
+- [Testing Automation](workflows/testing-automation.md) - Automated testing workflows
+
+### 🔗 Integration
+
+Integration with popular tools and platforms.
+
+- [GitHub Actions](integration/github-actions.md) - CI/CD integration
+- [Docker](integration/docker.md) - Containerization examples
+- [VS Code](integration/vscode.md) - Editor integration
+
+### ⚙️ Configuration
+
+Configuration examples and best practices.
+
+- [Basic Setup](configuration/basic-setup.md) - Initial configuration
+- [Advanced Config](configuration/advanced-config.md) - Advanced configuration patterns
+- [MCP Servers](configuration/mcp-servers.md) - MCP server configuration
+
+### 🔧 Troubleshooting
+
+Common issues and debugging techniques.
+
+- [Common Errors](troubleshooting/common-errors.md) - Frequent problems and solutions
+- [Debug Mode](troubleshooting/debug-mode.md) - Using debug features
+- [Performance](troubleshooting/performance.md) - Performance optimization
+
+### 📝 Recipes
+
+Quick solutions and useful snippets.
+
+- [Quick Tasks](recipes/quick-tasks.md) - One-line solutions
+- [Automation](recipes/automation.md) - Automation scripts
+- [Best Practices](recipes/best-practices.md) - Recommended patterns
+
+## 🚀 Quick Start
+
+```bash
+# View all examples
+roo examples
+
+# Show basic examples
+roo examples show basic
+
+# Search for specific examples
+roo examples search "web development"
+
+# Run a specific example
+roo examples run getting-started-hello-world
+
+# Get help on examples command
+roo examples --help
+```
+
+## 💡 Contributing Examples
+
+We welcome community contributions! To add your own examples:
+
+1. Choose the appropriate category
+2. Follow the example template format
+3. Include clear descriptions and expected outputs
+4. Test your examples before submitting
+5. Submit a pull request
+
+See our [contribution guidelines](../docs/contributing.md) for more details.

examples/basic/getting-started.md

@@ -0,0 +1,119 @@
+# Getting Started Examples
+
+These examples will help you take your first steps with the CLI utility.
+
+## Your First Command
+
+### Hello World
+
+```bash
+# Get basic help
+roo --help
+
+# Check version
+roo --version
+
+# Simple task
+roo "create a hello world script in Python"
+```
+
+**Expected Output:**
+The CLI will create a simple Python script with a hello world function.
+
+**Difficulty:** Beginner  
+**Estimated Time:** 1 minute  
+**Tags:** #basics #hello-world #python
+
+---
+
+### Basic File Operations
+
+```bash
+# Analyze a file
+roo "analyze this file: app.js"
+
+# Create multiple files
+roo "create a React component with tests"
+
+# Refactor code
+roo "refactor this function to use async/await: utils.js"
+```
+
+**Description:** Basic file manipulation commands that demonstrate core functionality.
+
+**Difficulty:** Beginner  
+**Estimated Time:** 2-3 minutes  
+**Tags:** #files #analysis #refactoring
+
+---
+
+### Getting Help
+
+```bash
+# General help
+roo --help
+
+# Help for specific commands
+roo help config
+
+# Help for tools
+roo help tools
+
+# Search help
+roo help search "file operations"
+```
+
+**Description:** Learn how to find help and documentation within the CLI.
+
+**Difficulty:** Beginner  
+**Estimated Time:** 1 minute  
+**Tags:** #help #documentation
+
+---
+
+### Basic Configuration
+
+```bash
+# Initialize configuration
+roo config init
+
+# View current configuration
+roo config list
+
+# Set a configuration value
+roo config set api.provider anthropic
+
+# Get a specific config value
+roo config get api.provider
+```
+
+**Description:** Basic configuration management to get started.
+
+**Prerequisites:**
+
+- CLI installed and accessible in PATH
+
+**Difficulty:** Beginner  
+**Estimated Time:** 2 minutes  
+**Tags:** #config #setup #basics
+
+---
+
+### Understanding Output
+
+```bash
+# Default output (plain text)
+roo "explain this code: function add(a, b) { return a + b; }"
+
+# JSON output for scripting
+roo --format json "list all functions in this file: utils.js"
+
+# Verbose output for debugging
+roo --verbose "analyze project structure"
+```
+
+**Description:** Understanding different output formats and verbosity levels.
+
+**Difficulty:** Beginner  
+**Estimated Time:** 2 minutes  
+**Tags:** #output #formats #debugging