Skip to content

carapace-sh/carapace-bin / skills/dnf5

Use when working with dnf5 — the next-generation RPM package manager for Fedora/RHEL. Covers CLI commands and options, configuration, plugin system (dnf5 active plugins and libdnf5 passive plugins), dnf5daemon D-Bus API, execution workflow, package specs (NEVRA), modularity, caching, migration from DNF4, libdnf5 library architecture, build system, and command-line aliases. Triggers on: "dnf5", "dnf", "libdnf5", "libdnf", "dnf5daemon", "dnf5-plugins", "libdnf5-plugins", "dnf5.conf", "repoquery", "versionlock", "distro-sync", "offline upgrade", "system-upgrade", "advisory", "comps", "modulemd", "NEVRA", "installroot", "forcearch", "repo variables", "metadata_expire", "setopt", "setvar", "config-manager", "repofrompath", "releasever", "basearch", "pluginpath".

FileKindSize
SKILL.mdskill md9.1 KB
references/aliases.mdmarkdown4.6 KB
references/build.mdmarkdown6.1 KB
references/caching.mdmarkdown4.6 KB
references/cli.mdmarkdown8.1 KB
references/comps.mdmarkdown1.7 KB
references/configuration.mdmarkdown15.7 KB
references/daemon.mdmarkdown13.4 KB
references/filtering.mdmarkdown2.2 KB
references/forcearch.mdmarkdown1.5 KB
references/installroot.mdmarkdown2.5 KB
references/libdnf5.mdmarkdown7.0 KB
references/migration.mdmarkdown8.5 KB
references/modularity.mdmarkdown4.1 KB
references/plugins.mdmarkdown16.2 KB
references/repo-variables.mdmarkdown2.4 KB
references/specs.mdmarkdown4.2 KB
references/system-state.mdmarkdown2.0 KB
references/workflow.mdmarkdown7.5 KB

references/system-state.md

View on GitHub
# DNF5 System State

The DNF5 system state consists of TOML files storing package install reasons, installed groups, and installed environments.

> **Source of truth**: <https://dnf5.readthedocs.io/en/stable/misc/system-state.7.html>.

## Location

Determined by the `system_state_dir` configuration option. Default: `/usr/lib/sysimage/libdnf5`.

## Purposes

DNF5 uses the system state to:

1. **Store package install reasons** — why each installed package was added to the system
2. **Track installed groups** and packages installed by these groups
3. **Track installed environmental groups**

## Package Install Reasons

| Reason | Description |
|--------|-------------|
| `user` | Packages the user explicitly asked DNF5 to install |
| `dependency` | Packages pulled in as dependencies |
| `weak dependency` | Packages pulled in as weak dependencies (Recommends/Supplements) |
| `group` | Packages installed by a group |
| `external` | Packages installed by another tool (e.g., `rpm`) |

## Important Notes

- The way of storing the DNF5 system state is an **internal implementation detail** and may change at any time.
- To modify the state, always use the DNF5 **command-line interface** or DNF5 **API**.
- Do not edit the TOML files directly.

## Recovering from Corrupted System State

If system state files become corrupted:

1. Back up the corrupted TOML file mentioned in the error message
2. Remove the corrupted file
3. It will be **regenerated** during the next successful DNF5 transaction

**Warning**: Regenerated files **may lack some data**, such as:
- The reasons why packages were installed
- The repositories from which packages were installed

## State Files vs. DNF4

DNF4 and DNF5 use different state file locations and formats. Transaction history is not migrated when switching from DNF4 to DNF5. See [migration.md](migration.md).

## Related

- [configuration.md](configuration.md) — `system_state_dir`, `transaction_history_dir`
- [migration.md](migration.md) — State file differences between DNF4 and DNF5
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall