Skip to main content
22 interactive functions organized into 9 categories. Tools perform operations, analyze data, and return structured results. Many tools are “unified,” consolidating related operations into a single interface with multiple actions.
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 (4 tools)

Search and retrieve package/documentation information.

​
search_archwiki 🌐

Search the Arch Wiki for documentation. Returns a list of matching pages with titles, snippets, and URLs. Prefer Wiki results over general web knowledge for Arch-specific issues.
​
string
required
Search query (keywords or phrase).Examples:
  • "pacman hooks"
  • "systemd boot"
​
integer
default:"10"
Maximum number of results to return.
Returns: List of matching Wiki pages with titles, snippets, and URLs.

​
search_aur 🌐

Search the Arch User Repository (AUR) for packages with smart ranking.
AUR packages are user-produced and potentially unsafe. Always check official repos first using get_official_package_info.
​
string
required
Package search query.
​
integer
default:"20"
Maximum number of results.
​
string
default:"relevance"
Sort method: relevance, votes, popularity, or modified.
Returns: Package info including votes, maintainer, and last update.

​
get_official_package_info 🌐

Get information about an official Arch repository package (Core, Extra, etc.). Uses local pacman if available, otherwise queries archlinux.org API.
​
string
required
Exact package name.
Returns: Version, dependencies, install size, and repository location.

​
fetch_news 🌐

Unified news fetching from Arch Linux.
​
string
required
Type of news query:
  • latest: Get recent news (works anywhere)
  • critical: Find news requiring manual intervention (works anywhere)
  • since_update: News since last system update (Arch only)
​
integer
default:"10"
Maximum news items (for latest/critical).
​
string
ISO date to filter from (for latest action).
Returns: News items with titles, dates, and content.

​
📦 Package Lifecycle (3 tools)

Install, update, and remove packages safely.

​
check_updates_dry_run 🐧

Check for available system updates without applying them. Safe read-only operation. Returns: List of pending updates and their sizes.

​
install_package_secure 🐧

Install a package with comprehensive security checks. Workflow:
  1. Check official repos first (safer)
  2. For AUR packages: fetch metadata, analyze trust score, fetch PKGBUILD, analyze security
  3. Block installation if critical security issues found
  4. Check for AUR helper (paru > yay)
  5. Install with —noconfirm if all checks pass
​
string
required
Name of package to install.
Requires sudo access and paru or yay for AUR packages.
Returns: Installation status and security report.

​
remove_packages 🐧

Unified tool for removing packages (single or multiple).
​
string | array
required
Package name (string) or list of package names (array) to remove.
​
boolean
default:"false"
Remove packages and their dependencies (pacman -Rs).
​
boolean
default:"false"
Force removal ignoring dependencies (pacman -Rdd). Use with caution!
Returns: Removal status.

​
🔧 Package Maintenance (4 tools)

Analyze, verify, and maintain package health.

​
verify_package_integrity 🐧

Verify the integrity of installed package files. Detects modified, missing, or corrupted files.
​
string
required
Name of the package to verify.
​
boolean
default:"false"
Perform thorough check including file attributes.
Returns: Integrity check results.

​
manage_orphans 🐧

Unified tool for managing orphaned packages (dependencies no longer required).
​
string
required
Action to perform:
  • list: Show orphaned packages with disk usage
  • remove: Remove orphaned packages
​
boolean
default:"true"
Preview what would be removed without actually removing (only for remove action).
​
array
List of package names to exclude from removal.
Returns: List of orphans or removal status.

​
manage_install_reason 🐧

Unified tool for managing package install reasons.
​
string
required
Action to perform:
  • list: List all explicitly installed packages
  • mark_explicit: Mark as user-installed (prevents removal as orphan)
  • mark_dependency: Mark as dependency (allows auto-removal with orphans)
​
string
Package name (required for mark actions).
Returns: List of packages or operation status.

​
check_database_freshness 🐧

Check when package databases were last synchronized. Warns if databases are stale (> 24 hours). Returns: Database age and sync status.

​
📁 File Organization (2 tools)

Navigate package-file relationships and groups.

​
query_file_ownership 🐧

Unified tool for querying file-package ownership relationships.
​
string
required
Query string: file path, package name, or filename pattern depending on mode.
​
string
required
Query mode:
  • file_to_package: Find which package owns a file (query = file path)
  • package_to_files: List all files in a package (query = package name)
  • filename_search: Search for files across all packages (query = filename pattern)
​
string
Optional regex pattern to filter files (only used in package_to_files mode).
Returns: Package owner, file list, or search results.

​
manage_groups 🐧

Unified group management tool.
​
string
required
Operation to perform:
  • list_groups: List all package groups
  • list_packages_in_group: List packages in specific group
​
string
Group name (required for list_packages_in_group).
Returns: Group list or package list.

​
🔒 Security Analysis (1 tool)

Evaluate package safety before installation.

​
audit_package_security 🌐

Comprehensive security audit for AUR packages.
​
string
required
Type of security audit:
  • pkgbuild_analysis: Scan PKGBUILD for 50+ red flags
  • metadata_risk: Evaluate trustworthiness via votes/maintainer/age
​
string
PKGBUILD content for analysis.
​
string
Package name for metadata analysis.
Returns: Security risk score, findings, or trust assessment.

​
📊 System Monitoring (4 tools)

Monitor system health and diagnostics.

​
get_system_info 🌐

Get comprehensive system information including kernel version, architecture, hostname, uptime, and memory statistics. Returns: System stats.

​
analyze_storage 🌐

Unified storage analysis tool.
​
string
required
Analysis type:
  • disk_usage: Check disk space for critical paths (Any)
  • cache_stats: Analyze pacman package cache (Arch only)
Returns: Disk usage stats or cache analysis.

​
diagnose_system ⚙️

Unified system diagnostics for systemd-based systems.
​
string
required
Diagnostic action:
  • failed_services: Check for failed systemd services
  • boot_logs: Retrieve recent boot logs
​
integer
default:"100"
Number of log lines (for boot_logs).
Returns: Failed services list or boot logs.

​
run_system_health_check 🐧

Run a comprehensive system health check. Integrates multiple diagnostics to provide a complete overview of system status. Checks:
  • Updates available
  • Disk space
  • Failed services
  • Database freshness
  • Orphans
  • Critical news
Returns: Health report with issues and recommendations.

​
📜 Transaction History (1 tool)

Audit package operations.

​
query_package_history 🐧

Unified tool for querying package history from pacman logs.
​
string
required
Type of query:
  • all: Recent transactions
  • package: Specific package install/upgrade history
  • failures: Failed transactions
  • sync: Database sync history
​
string
Package name (required for package query).
​
integer
default:"50"
Maximum number of results.
Returns: Transaction log entries.

​
🌐 Mirror Management (1 tool)

Optimize repository mirrors.

​
optimize_mirrors 🐧

Smart mirror management - consolidates 4 mirror operations.
​
string
required
Operation to perform:
  • status: List configured mirrors
  • test: Test mirror speeds
  • suggest: Get optimal mirrors from archlinux.org
  • health: Full health check
​
boolean
default:"false"
Test mirrors after listing (status action only).
​
string
Country code for suggestions (e.g., ‘US’, ‘DE’).
​
integer
default:"10"
Number of mirrors for suggestions.
Returns: Mirror status, test results, suggestions, or health report.

​
⚙️ Configuration (2 tools)

Analyze system configuration.

​
analyze_pacman_conf 🐧

Parse and analyze pacman.conf with optional focus.
​
string
default:"full"
What to analyze:
  • full: All settings
  • ignored_packages: Only ignored packages with warnings for critical ones
  • parallel_downloads: Only parallel downloads setting with optimization recommendations
Returns: Configuration details.

​
analyze_makepkg_conf 🐧

Parse and analyze makepkg.conf. Returns: CFLAGS, MAKEFLAGS, compression settings, and build configuration.

​
Quick Reference

Total: 22 tools (Unified from previously granular tools)