x-system

# x-cmd System Administration Tools ## Overview This skill provides professional system administration and monitoring capabilities through the x-cmd ecosystem. The tools enable system administrators, developers, and power users to manage processes, monitor system health, configure network settings, and analyze storage directly from the terminal. ## Available Tools ### Process Management (ps) Enhanced process monitoring and management with interactive interfaces. - **Usage**: `x ps [flags]` - **Key features**: - Interactive CSV application for process viewing - FZF-based interactive process selection - Multiple output formats (CSV, TSV, JSON) - Process data conversion utilities - **Examples**: - `x ps` - Interactive process viewer - `x ps fz` - FZF-based process selection - `x ps --csv` - CSV format output - `ps -ef | x ps --tojson` - Convert process data to JSON ### macOS System Utilities (mac) Comprehensive macOS management and automation tools. - **Usage**: `x mac [subcommand]` - **Key subcommands**: - `info` - Display system information - `battery` - Battery status and health - `disk` - Disk management - `vol` - Volume control - `lock` - Desktop lock screen - `sleep` - Enter sleep mode - `net` - Network management - `wifi` - Wi-Fi configuration - **Examples**: - `x mac info` - Display system information - `x mac b` - Get battery information - `x mac vol set 24` - Set output volume to 24% - `x mac lock` - Lock desktop - `x mac net test` - Test network quality ### Network Configuration (ip) Advanced IP address management and network analysis. - **Usage**: `x ip [subcommand]` - **Key subcommands**: - `ls` - List all local IP addresses - `geolite` - IP geolocation lookup - `config` - Network interface configuration - `addr` - IP address information - `cidr` - CIDR network calculations - `map` - Active host discovery - `tcp-portscan` - TCP port scanning - **Examples**: - `x ip` - List all local IP addresses - `x ip geolite 8.8.8.8` - Get IP geolocation - `x ip map` - Discover active hosts in network - `x ip tcp-portscan` - TCP port discovery ### Disk Health Monitoring (smart) SMART disk health monitoring and analysis. - **Usage**: `x smart [flags] [device]` - **Key features**: - Interactive disk selection interface - Comprehensive SMART data display - Root privilege handling automation - Integration with AI analysis tools - **Examples**: - `x smart` - Interactive disk health viewer - `x smart -a /dev/disk0` - Display all SMART info for disk0 - `x smart -a /dev/disk0 | @gemini generate a report` - AI-generated disk health report - `x smart : disk health` - Search disk health information ### Storage Analysis (df) Enhanced disk space monitoring with multiple output formats. - **Usage**: `x df [flags]` - **Key features**: - Automatic TUI/TSV output based on terminal type - Multiple output formats (CSV, TSV, TUI) - Cross-platform compatibility - Interactive table interface - **Examples**: - `x df` - Auto-detect output format (TUI/TSV) - `x df --csv` - CSV format output - `x df --tsv` - TSV format output - `x df --app` - Interactive TUI application ## System Administration Use Cases ### System Monitoring - Use `x ps` for real-time process monitoring - Use `x df` for disk space analysis - Use `x mac info` for system health overview - Use `x smart` for disk health monitoring ### Network Management - Use `x ip ls` for network interface analysis - Use `x ip geolite` for IP geolocation - Use `x ip map` for network discovery - Use `x mac net` for macOS network management ### System Maintenance - Use `x mac disk` for disk management - Use `x mac trash` for system cleanup - Use `x mac battery` for power management - Use `x mac vol` for audio control ### Security and Access Control - Use `x mac lock` for workstation security - Use `x mac tidsudo` for TouchID authentication - Use `x mac fw` for firewall management - Use `x mac sshd` for SSH server configuration ## Installation and Setup ### Prerequisites - x-cmd CLI installed - Appropriate system permissions - Internet connection (for geolocation and search features) ### Platform-Specific Requirements #### macOS - Most `x mac` commands work natively - Some features require administrator privileges - TouchID integration available for supported systems #### Linux - `x smart` automatically handles sudo privileges - Network tools work across distributions - Process management compatible with standard Linux ps #### Windows - Limited macOS-specific functionality - Network and process tools available - Storage analysis works across platforms ### Configuration #### Process Management ```bash x ps --help # View all available options ``` #### macOS System ```bash x mac alias enable m # Set alias for quick access ``` #### Network Tools ```bash x ip --help # View network analysis options ``` ## Integration with Other Tools ### Data Processing - Pipe output to `x jq` for JSON processing - Use with `@zh` for Chinese translation - Export to CSV/TSV for spreadsheet analysis ### AI Integration - Use `@gemini` for AI-powered analysis - Generate reports from system data - Get recommendations for system optimization ### Automation - Combine with shell scripts for automated monitoring - Schedule regular system health checks - Create custom system administration workflows ## Troubleshooting ### Common Issues - **Permission errors**: Ensure appropriate privileges for system commands - **Network connectivity**: Check internet connection for geolocation services - **Device detection**: Verify disk devices are accessible for SMART monitoring - **Platform compatibility**: Some tools are macOS-specific ### Performance Optimization - Use specific queries rather than broad searches - Cache results when appropriate for monitoring - Use interactive interfaces for complex analysis ### System-Specific Considerations - **macOS**: Some commands require SIP (System Integrity Protection) considerations - **Linux**: SMART monitoring requires appropriate device permissions - **Cross-platform**: Output formats standardized across platforms ## Support and Resources - **x-cmd System Documentation**: https://x-cmd.com/mod/system - **Process Management**: https://x-cmd.com/mod/ps - **macOS Utilities**: https://x-cmd.com/mod/mac - **Network Tools**: https://x-cmd.com/mod/ip - **Disk Health**: https://x-cmd.com/mod/smart - **Storage Analysis**: https://x-cmd.com/mod/df For additional help: - Use `x [tool] --help` for specific tool documentation - Visit individual module pages for detailed usage - Check platform-specific requirements for each tool