Platform Requirements: Tools are marked as:
- 🌐 Any - Works on all platforms (uses remote APIs)
- 🐧 Arch - Requires Arch Linux
- ⚙️ systemd - Requires systemd (most Linux distros)
🔍 Discovery & Information (6 tools)
Search and retrieve package/documentation information.search_archwiki 🌐
Query Arch Wiki documentation with intelligent ranking using the MediaWiki API.Search terms or keywords to find in the Arch Wiki.Examples:
"systemd boot configuration""dual boot windows""wifi troubleshooting"
Maximum number of results to return. Range: 1-50.
Array of matching Wiki pages ranked by relevance.
search_aur 🌐
Search AUR packages with smart ranking algorithms. Parameters:query(string): Package name or description keywordssort_by(optional):relevance,votes,popularity,modified
analyze_package_metadata_risk, analyze_pkgbuild_safety, install_package_secure
get_official_package_info 🌐
Lookup official repository packages with hybrid local/remote search. Parameters:package(string): Package name
search_aur, install_package_secure
get_latest_news 🌐
Fetch Arch Linux news from RSS feed. Parameters:limit(optional): Number of news items (default: 10)
check_critical_news, get_news_since_last_update
check_critical_news 🌐
Find critical news requiring manual intervention. Parameters: None Returns: Critical news items with manual action flags Related:get_latest_news, check_updates_dry_run
get_news_since_last_update 🐧
News posted since last system update. Parameters: None Returns: News items between last DB sync and now Related:get_latest_news, check_critical_news
📦 Package Lifecycle (4 tools)
Install, update, and remove packages safely.check_updates_dry_run 🐧
Check for available updates without modifying system. Parameters: None Returns: List of packages with available updates Related:check_critical_news, check_disk_space
install_package_secure 🐧
Securely install packages with automated pre-installation security checks and confirmations.Name of the package to install. Can be from official repositories or AUR.Examples:
"python""yay"(AUR)"visual-studio-code-bin"(AUR)
Force installation from AUR. If
false, the tool auto-detects whether to use official repos or AUR.Skip security checks (NOT RECOMMENDED). Only use for trusted packages.
- ✅ Automatic security scanning before installation
- ✅ Blocks packages with critical security threats
- ✅ Requires confirmation for AUR packages
- ✅ Checks for AUR helper (paru or yay)
- ✅ Validates package exists before attempting install
- ✅ Shows detailed security report
Installation status:
"success", "blocked", "failed", or "cancelled"Name of the package that was installed or attempted.
Version of the package that was installed.
Where the package came from:
"official" or "aur"Results of pre-installation security checks.
Full installation log from pacman/AUR helper.
List of files installed by the package.
Workflow: This tool automatically runs:
get_official_package_info- Check if package is officialanalyze_pkgbuild_safety- Scan PKGBUILD (if AUR)analyze_package_metadata_risk- Evaluate trust (if AUR)- Installation with confirmation prompt
get_official_package_info, analyze_pkgbuild_safety, analyze_package_metadata_risk
Related: check_updates_dry_run, verify_package_integrity, get_transaction_history
remove_package 🐧
Remove single package with dependency handling. Parameters:package(string): Package namerecursive(optional): Remove deps (default: false)force(optional): Force removal (default: false)
remove_packages_batch, list_orphan_packages
remove_packages_batch 🐧
Remove multiple packages efficiently in one operation. Parameters:packages(array): List of package namesrecursive(optional): Remove deps (default: false)
remove_package, remove_orphans
🔧 Package Maintenance (7 tools)
Analyze, verify, and maintain package health.list_orphan_packages 🐧
Find packages installed as dependencies but no longer required. Parameters: None Returns: List of orphaned packages with sizes Related:remove_orphans, mark_as_explicit
remove_orphans 🐧
Clean orphaned packages with safety checks. Parameters:dry_run(optional): Preview only (default: true)exclude(optional): Packages to keep
list_orphan_packages
Related: list_orphan_packages
verify_package_integrity 🐧
Check package file integrity for modifications or corruption. Parameters:package(string): Package name
get_transaction_history, find_package_owner
list_explicit_packages 🐧
List packages explicitly installed by user. Parameters: None Returns: User-installed packages (excludes dependencies) Related:mark_as_explicit, mark_as_dependency
mark_as_explicit 🐧
Prevent package from being orphaned by marking as user-installed. Parameters:package(string): Package name
list_explicit_packages, list_orphan_packages
mark_as_dependency 🐧
Allow package to be orphaned by marking as dependency. Parameters:package(string): Package name
list_explicit_packages, list_orphan_packages
check_database_freshness 🐧
Check when package database was last synced. Parameters: None Returns: Last sync timestamp and age warnings Related:get_database_sync_history
📁 File Organization (5 tools)
Navigate package-file relationships and groups.find_package_owner 🐧
Find which package owns a specific file. Parameters:file_path(string): Absolute file path
list_package_files, verify_package_integrity
list_package_files 🐧
List all files installed by a package. Parameters:package(string): Package namefilter_regex(optional): Regex pattern to filter files
find_package_owner, search_package_files
search_package_files 🐧
Search for files across all packages. Parameters:pattern(string): Search pattern (filename or regex)
list_package_files, find_package_owner
list_package_groups 🐧
List all package groups (base, base-devel, etc.). Parameters: None Returns: All groups with member counts Related:list_group_packages
list_group_packages 🐧
Show packages in a specific group. Parameters:group(string): Group name
list_package_groups
Related: list_package_groups
🔒 Security Analysis (2 tools)
Evaluate package safety before installation.analyze_pkgbuild_safety 🌐
Comprehensive PKGBUILD security analysis using 50+ threat detection patterns.Name of the AUR package to analyze. The tool fetches and scans the PKGBUILD automatically.Examples:
"yay""neofetch""spotify"
- ✅ 50+ red flag patterns
- ✅ Malicious command detection
- ✅ Obfuscation analysis
- ✅ Crypto miner signatures
- ✅ Rootkit technique scanning
- ✅ Network security checks
Overall risk score from 0-100. Higher scores indicate more risk.
- 0-20: LOW risk
- 21-50: MEDIUM risk
- 51-80: HIGH risk
- 81-100: CRITICAL risk
Human-readable risk level:
"LOW", "MEDIUM", "HIGH", or "CRITICAL"Detailed list of security findings with context.
List of critical security threats detected (e.g.,
rm -rf /, fork bombs).List of suspicious patterns that warrant manual review.
General warnings about the PKGBUILD’s security posture.
Overall recommendation: install, review carefully, or avoid.
- 🔴 Dangerous:
rm -rf /,dd if=/dev/zero, fork bombs - 🟠 Suspicious:
curl|sh,wget|sh, base64 pipes, eval statements - 🟡 Warnings: chmod 777, binary downloads, external scripts
analyze_package_metadata_risk, install_package_secure
analyze_package_metadata_risk 🌐
Package trust scoring based on community metrics. Parameters:package(string): AUR package name
- Vote count and popularity
- Maintainer presence and reputation
- Package age and update frequency
- Out-of-date status
search_aur
Related: analyze_pkgbuild_safety, install_package_secure
📊 System Monitoring (5 tools)
Monitor system health and diagnostics.get_system_info 🌐
Retrieve system information and resource usage. Parameters: None Returns: Kernel version, memory usage, uptime, CPU info Related:check_disk_space, check_failed_services
check_disk_space 🌐
Disk usage statistics with capacity warnings. Parameters:warning_threshold(optional): Warn if above % (default: 80)
get_pacman_cache_stats, list_orphan_packages
get_pacman_cache_stats 🐧
Package cache size and age analysis. Parameters: None Returns: Cache size, package count, oldest package date Related:check_disk_space
check_failed_services ⚙️
Find failed systemd services. Parameters: None Returns: Failed service units with status details Related:get_boot_logs, get_system_info
get_boot_logs ⚙️
Retrieve journalctl boot logs for diagnostics. Parameters:lines(optional): Number of lines (default: 100)priority(optional): Log level filter (default: all)
check_failed_services
📜 Transaction History (4 tools)
Audit package operations and database events.get_transaction_history 🐧
Recent package transactions (install/upgrade/remove). Parameters:limit(optional): Number of transactions (default: 20)
find_when_installed, find_failed_transactions
find_when_installed 🐧
Package installation history and timeline. Parameters:package(string): Package name
get_transaction_history
find_failed_transactions 🐧
Failed package operations from pacman logs. Parameters: None Returns: Failed transactions with error messages Related:get_transaction_history
get_database_sync_history 🐧
Database synchronization event log. Parameters:limit(optional): Number of events (default: 10)
check_database_freshness
🌐 Mirror Management (4 tools)
Optimize repository mirrors for speed and reliability.list_active_mirrors 🐧
Show currently configured mirrors from mirrorlist. Parameters: None Returns: Active mirror URLs with protocols Related:test_mirror_speed, check_mirrorlist_health
test_mirror_speed 🐧
Test latency to configured mirrors. Parameters:timeout(optional): Test timeout in seconds (default: 5)
list_active_mirrors
Related: suggest_fastest_mirrors, list_active_mirrors
suggest_fastest_mirrors 🌐
Recommend optimal mirrors by geographic location. Parameters:country(optional): ISO country code (default: auto-detect)protocol(optional): http/https (default: https)
test_mirror_speed
check_mirrorlist_health 🐧
Verify mirror configuration validity. Parameters: None Returns: Configuration health status and warnings Related:list_active_mirrors, suggest_fastest_mirrors
⚙️ Configuration Management (4 tools)
Analyze system configuration files.analyze_pacman_conf 🐧
Parse pacman.conf settings and options. Parameters: None Returns: Configuration map with repositories, options, ignore lists Related:check_ignored_packages, get_parallel_downloads_setting
analyze_makepkg_conf 🐧
Parse makepkg.conf build settings. Parameters: None Returns: Build flags, compression settings, package destinations Related:analyze_pacman_conf
check_ignored_packages 🐧
List packages excluded from updates. Parameters: None Returns: Ignored packages with critical package warnings Related:analyze_pacman_conf
get_parallel_downloads_setting 🐧
Get parallel download configuration value. Parameters: None Returns: Parallel download count or “disabled” Related:analyze_pacman_conf
Common Workflows
Many tools work better together. Here are proven workflows for common tasks.Safe AUR Installation Workflow
Safe AUR Installation Workflow
Security-first package installation from AUR.Find the package and check popularity.Evaluate maintainer reputation and community trust.Deep scan PKGBUILD for malicious patterns.Automated installation with final confirmation.
1
Search for package
2
Check trust score
3
Scan for threats
4
Install if safe
System Cleanup Workflow
System Cleanup Workflow
Free up disk space by removing unused packages safely.See current disk usage and identify space issues.List packages no longer required by any installed package.See what would be removed without actually removing anything.See how much space is used by package cache.Remove orphans and clean package cache.
1
Check disk usage
2
Find orphaned packages
3
Preview removal
4
Check cache size
5
Clean system
Mirror Optimization Workflow
Mirror Optimization Workflow
Optimize repository mirrors for faster downloads.See which mirrors you’re currently using.Check latency and availability of current mirrors.Find optimal mirrors for your location.Validate that mirrorlist is properly configured.
1
List current mirrors
2
Test mirror speeds
3
Get recommendations
4
Verify configuration
5
Update mirrorlist
Manual step: Edit
/etc/pacman.d/mirrorlist with recommended mirrors.Consider using reflector for automated mirror management.
Troubleshooting Workflow
Troubleshooting Workflow
Diagnose system issues using diagnostic tools.Get overview of system resources and capacity.Find systemd services that failed to start.Check boot logs for errors and warnings.Find relevant Wiki pages for your issue.Review recent package operations for failures.
1
Check system health
2
Check for failed services
3
Review boot logs
4
Search Wiki for solutions
5
Check transaction history
Pre-Update Check Workflow
Pre-Update Check Workflow
Safe system update preparation workflow.Review Arch news for manual intervention requirements.See what packages will be updated.Ensure sufficient space for updates.Verify package database is recent.
1
Check for critical news
2
Check available updates
3
Verify disk space
4
Check database freshness
5
Perform update
Manual step: Run
sudo pacman -Syu after reviewing all checks.Package Investigation Workflow
Package Investigation Workflow
Deep dive into a package’s details and relationships.Get basic metadata and dependencies.See when and why package was installed.See all files installed by this package.Check if files have been modified or corrupted.Understand why package is on your system.
1
Get package info
2
Check installation history
3
List package files
4
Verify integrity
5
Check installation reason
Quick Reference
| Category | Count | Permission | Platform Mix |
|---|---|---|---|
| Discovery & Information | 6 | Read | 5 Any, 1 Arch |
| Package Lifecycle | 4 | Write | All Arch |
| Package Maintenance | 7 | Mixed | All Arch |
| File Organization | 5 | Read | All Arch |
| Security Analysis | 2 | Read | All Any |
| System Monitoring | 5 | Read | 3 Any, 2 systemd, 1 Arch |
| Transaction History | 4 | Read | All Arch |
| Mirror Management | 4 | Read | 3 Arch, 1 Any |
| Configuration | 4 | Read | All Arch |