> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nihalxkumar.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Resources

> URI-based access to Arch ecosystem data

Direct access to Arch ecosystem data via custom URI schemes. Resources provide read-only access to Wiki pages, package information, and system data.

## Available Resources

| URI Scheme                    | Example                         | Returns                                         |
| ----------------------------- | ------------------------------- | ----------------------------------------------- |
| `archwiki://`                 | `archwiki://Installation_guide` | Markdown-formatted Wiki page                    |
| `aur://*/pkgbuild`            | `aur://yay/pkgbuild`            | Raw PKGBUILD with safety analysis               |
| `aur://*/info`                | `aur://yay/info`                | AUR package metadata (votes, maintainer, dates) |
| `archrepo://`                 | `archrepo://vim`                | Official repository package details             |
| `pacman://installed`          | `pacman://installed`            | System installed packages list (Arch only)      |
| `pacman://orphans`            | `pacman://orphans`              | Orphaned packages list (Arch only)              |
| `pacman://explicit`           | `pacman://explicit`             | Explicitly installed packages (Arch only)       |
| `pacman://groups`             | `pacman://groups`               | All package groups (Arch only)                  |
| `pacman://group/*`            | `pacman://group/base-devel`     | Packages in specific group (Arch only)          |
| `pacman://database/freshness` | `pacman://database/freshness`   | Package database sync status (Arch only)        |
| `pacman://log/recent`         | `pacman://log/recent`           | Recent package transactions (Arch only)         |
| `pacman://log/failed`         | `pacman://log/failed`           | Failed package transactions (Arch only)         |
| `system://info`               | `system://info`                 | System information (kernel, memory, uptime)     |
| `system://disk`               | `system://disk`                 | Disk space usage statistics                     |
| `system://services/failed`    | `system://services/failed`      | Failed systemd services                         |
| `system://logs/boot`          | `system://logs/boot`            | Recent boot logs                                |
| `archnews://latest`           | `archnews://latest`             | Latest Arch Linux news                          |
| `archnews://critical`         | `archnews://critical`           | Critical news requiring manual intervention     |
| `archnews://since-update`     | `archnews://since-update`       | News since last system update (Arch only)       |
| `config://pacman`             | `config://pacman`               | Parsed pacman.conf configuration (Arch only)    |
| `config://makepkg`            | `config://makepkg`              | Parsed makepkg.conf configuration (Arch only)   |
| `mirrors://active`            | `mirrors://active`              | Currently configured mirrors (Arch only)        |
| `mirrors://health`            | `mirrors://health`              | Mirror configuration health status (Arch only)  |
| `system://health`             | `system://health`               | Comprehensive system health check report        |

## How to Use Resources

Resources are accessed through URI schemes in MCP-compatible clients. Each resource provides structured data that AI assistants can process and present in digestible formats.

### Arch Wiki Resources

**URI Scheme:** `archwiki://PAGE_NAME`

Access any Arch Wiki page in Markdown format. The page name should match the Wiki URL slug.

**Examples:**

```
archwiki://Installation_guide
archwiki://Systemd
archwiki://Pacman
archwiki://GRUB
```

**Returns:**

* Full Wiki page content in Markdown
* Formatted sections and code blocks
* Preserved links and references

### AUR PKGBUILD Resources

**URI Scheme:** `aur://PACKAGE_NAME/pkgbuild`

Fetch raw PKGBUILD files with automatic safety analysis annotations.

**Examples:**

```
aur://yay/pkgbuild
aur://paru/pkgbuild
aur://visual-studio-code-bin/pkgbuild
```

**Returns:**

* Raw PKGBUILD content
* Inline safety warnings for suspicious patterns
* Dependency information
* Build instructions

### AUR Package Info Resources

**URI Scheme:** `aur://PACKAGE_NAME/info`

Retrieve comprehensive AUR package metadata.

**Examples:**

```
aur://yay/info
aur://spotify/info
aur://zoom/info
```

**Returns:**

* Package name and description
* Maintainer information
* Vote count and popularity
* Last modified date
* Dependencies and conflicts
* License information

### Official Repository Resources

**URI Scheme:** `archrepo://PACKAGE_NAME`

Query official Arch Linux repository packages.

**Examples:**

```
archrepo://vim
archrepo://python
archrepo://firefox
archrepo://nginx
```

**Returns:**

* Package version and architecture
* Repository location (core, extra, community)
* Dependencies and optional dependencies
* Package size and install date
* Description and homepage

### Installed Packages Resources

**URI Scheme:** `pacman://installed`

List all packages currently installed on the system (Arch Linux only).

**Examples:**

```
pacman://installed
```

**Returns:**

* Complete list of installed packages
* Version numbers
* Install dates
* Package sizes

**Note:** This resource only works on Arch Linux systems with pacman installed.

### Orphan Packages Resources

**URI Scheme:** `pacman://orphans`

List all orphaned packages (dependencies no longer required by any installed package) on the system (Arch Linux only).

**Examples:**

```
pacman://orphans
```

**Returns:**

* List of orphaned packages
* Package sizes
* Total space that can be freed
* Installation dates

**Use Case:** Identify packages that can be safely removed to free up disk space.

### Explicit Packages Resources

**URI Scheme:** `pacman://explicit`

List all packages explicitly installed by the user (not installed as dependencies) on the system (Arch Linux only).

**Examples:**

```
pacman://explicit
```

**Returns:**

* List of user-installed packages
* Version numbers
* Install dates
* Total package count

**Use Case:** Create backup lists for system migration or understand which packages you personally installed.

### Package Groups Resources

**URI Scheme:** `pacman://groups`

List all available package groups in the repositories (Arch Linux only).

**Examples:**

```
pacman://groups
```

**Returns:**

* List of all package groups
* Group names
* Number of packages per group

**Use Case:** Discover package collections like `base-devel`, `gnome`, `kde-applications`.

### Specific Group Packages Resources

**URI Scheme:** `pacman://group/GROUP_NAME`

List all packages in a specific package group (Arch Linux only).

**Examples:**

```
pacman://group/base-devel
pacman://group/gnome
pacman://group/xorg
```

**Returns:**

* List of packages in the group
* Installation status for each package
* Package versions
* Total package count

**Use Case:** Review what packages are included before installing a group.

### System Information Resources

**URI Scheme:** `system://info`

Get comprehensive system information.

**Examples:**

```
system://info
```

**Returns:**

* Kernel version and release
* System architecture (x86\_64, aarch64, etc.)
* Hostname
* System uptime
* Memory statistics (total, available, used)

**Use Case:** Quick system diagnostics and troubleshooting context.

### Disk Space Resources

**URI Scheme:** `system://disk`

Check disk space usage for critical filesystem paths.

**Examples:**

```
system://disk
```

**Returns:**

* Usage statistics for: `/`, `/home`, `/var`, `/var/cache/pacman/pkg`
* Available space
* Low space warnings (\< 10% free)

**Use Case:** Monitor disk usage before installations or identify space issues.

### Failed Services Resources

**URI Scheme:** `system://services/failed`

List all failed systemd services (systemd-based systems).

**Examples:**

```
system://services/failed
```

**Returns:**

* List of failed service units
* Service status
* Brief error summaries

**Use Case:** System health checks and troubleshooting service failures.

### Boot Logs Resources

**URI Scheme:** `system://logs/boot`

Retrieve recent boot logs from the current boot session (systemd-based systems).

**Examples:**

```
system://logs/boot
```

**Returns:**

* Boot log entries
* Timestamps
* Log levels (info, warning, error)
* Service startup information

**Use Case:** Diagnose boot issues, startup problems, or service failures.

### System Health Resources

**URI Scheme:** `system://health`

Get a comprehensive system health check report integrating multiple diagnostics.

**Examples:**

```
system://health
```

**Returns:**

* Overall system health status
* List of failed checks or warnings
* Resource usage summary
* Package maintenance status
* Mirror health status

**Use Case:** Single-point check for overall system status.

### Package Database Freshness Resources

**URI Scheme:** `pacman://database/freshness`

Check when the package database was last synchronized (Arch Linux only).

**Examples:**

```
pacman://database/freshness
```

**Returns:**

* Last sync timestamp
* Days since last sync
* Recommendations if database is stale

**Use Case:** Verify package database is up-to-date before installations or updates.

### Recent Transaction Log Resources

**URI Scheme:** `pacman://log/recent`

View recent package transactions from pacman log (Arch Linux only).

**Examples:**

```
pacman://log/recent
```

**Returns:**

* Recent install/upgrade/remove operations
* Timestamps
* Package versions
* Transaction details

**Use Case:** Track recent system changes and package history.

### Failed Transaction Log Resources

**URI Scheme:** `pacman://log/failed`

List failed package operations from pacman log (Arch Linux only).

**Examples:**

```
pacman://log/failed
```

**Returns:**

* Failed transactions
* Error messages
* Timestamps
* Affected packages

**Use Case:** Troubleshoot installation failures and dependency issues.

### Latest News Resources

**URI Scheme:** `archnews://latest`

Fetch the latest Arch Linux news from the official feed.

**Examples:**

```
archnews://latest
```

**Returns:**

* Recent news articles
* Publication dates
* Article content
* Links to full articles

**Use Case:** Stay informed about important Arch Linux updates and announcements.

### Critical News Resources

**URI Scheme:** `archnews://critical`

Filter news that requires manual intervention before system updates.

**Examples:**

```
archnews://critical
```

**Returns:**

* Critical announcements
* Manual intervention requirements
* Action items
* Deadlines

**Use Case:** Check for breaking changes before running system updates.

### News Since Update Resources

**URI Scheme:** `archnews://since-update`

Get news posted since your last system update (Arch Linux only).

**Examples:**

```
archnews://since-update
```

**Returns:**

* Unread news articles
* Last update timestamp
* Important announcements you may have missed

**Use Case:** Ensure you haven't missed critical news before updating.

### Pacman Configuration Resources

**URI Scheme:** `config://pacman`

Parse and analyze pacman.conf configuration (Arch Linux only).

**Examples:**

```
config://pacman
```

**Returns:**

* Enabled repositories
* Configuration options
* Ignored packages
* Parallel downloads setting
* Architecture settings

**Use Case:** Review system package manager configuration.

### Makepkg Configuration Resources

**URI Scheme:** `config://makepkg`

Parse and analyze makepkg.conf configuration (Arch Linux only).

**Examples:**

```
config://makepkg
```

**Returns:**

* Build flags (CFLAGS, CXXFLAGS)
* Architecture settings
* Packager information
* Compression settings
* Build environment configuration

**Use Case:** Review package building configuration for AUR packages.

### Active Mirrors Resources

**URI Scheme:** `mirrors://active`

List currently configured repository mirrors (Arch Linux only).

**Examples:**

```
mirrors://active
```

**Returns:**

* Active mirror URLs
* Mirror countries
* Protocol (http/https)
* Mirror configuration order

**Use Case:** Verify mirror configuration and order.

### Mirror Health Resources

**URI Scheme:** `mirrors://health`

Check mirror configuration health and status (Arch Linux only).

**Examples:**

```
mirrors://health
```

**Returns:**

* Mirror availability
* Configuration issues
* Health warnings
* Recommendations

**Use Case:** Diagnose mirror-related download issues.

## Resource Usage Patterns

### Documentation Lookup

```
1. Search Wiki: archwiki://Package_management
2. Get specific guide: archwiki://Installation_guide
3. Review troubleshooting: archwiki://System_maintenance
```

### Package Research

```
1. Check official repo: archrepo://package-name
2. If not found, check AUR: aur://package-name/info
3. Review PKGBUILD: aur://package-name/pkgbuild
```

### System Audit

```
1. List installed packages: pacman://installed
2. Check package details: archrepo://package-name
3. Review documentation: archwiki://Package_name
```

## Learn More

<CardGroup cols={2}>
  <Card title="Tools" icon="wrench" href="/arch-mcp/tools">
    Executable functions for search and operations
  </Card>

  <Card title="Prompts" icon="messages" href="/arch-mcp/prompts">
    Guided workflows combining multiple steps
  </Card>
</CardGroup>