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/aliases.md

View on GitHub
# DNF5 Command-Line Aliases

DNF5 supports custom aliases for commands and options using TOML configuration files. Aliases abbreviate longer command and option sequences.

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

## Configuration Locations

Aliases are loaded from these drop-in directories (in order):

1. `/usr/share/dnf5/aliases.d/` — Distribution aliases
2. `/etc/dnf/dnf5-aliases.d/` — System-wide user aliases
3. `$XDG_CONFIG_HOME/dnf5/aliases.d/` — Per-user aliases

## File Format

TOML format. Must begin with the `version` attribute:

```toml
version = '1.1'
```

Each alias is defined in a separate TOML section. The section name uniquely identifies the alias and defines its scope using dot-separated paths:

```toml
['group.list.in']    # alias only within 'group list' subcommand
```

## Alias Types

### 1. `command` — Alias for a command

Defines an alias for a command or subcommand sequence.

**Required keys**: `type`, `attached_command`

**Optional keys**: `descr.<locale>` (v1.1), `descr` (deprecated v1.1), `group_id`, `complete` (default: `false`), `required_values` (v1.1), `attached_named_args`

```toml
['grouplist']
type = 'command'
attached_command = 'group.list'

['list-fedora-all']
type = 'command'
attached_command = 'list'
attached_named_args = [
    { id_path = 'repo', value = 'fedora' },
    { id_path = 'list.showduplicates' }
]
```

### 2. `cloned_named_arg` — Alias for an existing option

Defines another name for a given option.

**Required keys**: `type`, either `long_name` or `short_name`, `source`

```toml
['nobest']
type = 'cloned_named_arg'
long_name = 'nobest'
source = 'no-best'

['repoquery.list']
type = 'cloned_named_arg'
long_name = 'list'
short_name = 'l'
source = 'repoquery.files'
```

### 3. `named_arg` — Alias that replaces multiple options

Defines an alias option that can substitute multiple options and define values for each.

**Required keys**: `type`, either `long_name` or `short_name`

**Optional keys**: `descr.<locale>` (v1.1), `descr` (deprecated), `has_value` (default: `false`), `value_help.<locale>` (v1.1), `value_help` (deprecated), `const_value`, `group_id`, `complete`, `attached_named_args`

The `value` in `attached_named_args` can contain `${}` placeholders that are substituted with the alias option's value.

```toml
['list.all-available']
type = 'named_arg'
long_name = 'all-available'
attached_named_args = [
    { id_path = 'list.showduplicates' },
    { id_path = 'list.available' }
]

['download.dest']
type = 'named_arg'
long_name = 'dest'
has_value = true
value_help.C = 'DESTDIR'
attached_named_args = [
    { id_path = 'download.destdir', value = '${}' }
]

['settsflags']
type = 'named_arg'
long_name = 'settsflags'
has_value = true
value_help.C = 'TS_FLAGS'
attached_named_args = [
    { id_path = 'setopt', value = 'tsflags=${}' }
]
```

### 4. `group` — Groups multiple aliases together

Defines a group header for organizing aliases in help output.

**Required keys**: `type`, `header.<locale>` (v1.1) or `header` (deprecated)

```toml
['repo.query-aliases']
type = 'group'
header.C = 'Query Aliases:'
```

Aliases reference the group via `group_id = 'repo.query-aliases'`.

## Value Placeholders

In `attached_named_args`, the `value` field supports placeholders:

| Placeholder | Meaning |
|-------------|---------|
| `${}` | The value of the alias option (when `has_value = true`) |
| `${1}`, `${2}`, ... | Consumed positional values (index 1 = first value) |

## `required_values` (v1.1)

Defines positional arguments consumed by the alias:

```toml
['whatrequires']
type = 'command'
attached_command = 'repoquery'
required_values = [
    { value_help.C = 'PACKAGE' }
]
attached_named_args = [
    { id_path = 'repoquery.installed' },
    { id_path = 'repoquery.whatrequires', value = '${1}' }
]
```

## `attached_named_args` Structure

An array of tables, each must contain `id_path` (the path to the option being attached). Optional `value` field:

```toml
attached_named_args = [
    { id_path = 'repo', value = 'fedora' },
    { id_path = 'list.showduplicates' }
]
```

- `id_path` — Dot-separated path to the option being set
- `value` — Value for the option. Can contain `${}` and `${index}` placeholders.

## `complete` Flag

When `complete = true`, bash autocompletion is enabled for the alias. Default: `false`.

## Localization

v1.1 added locale support:
- `descr.<locale>` — Description in specific locale (e.g., `descr.en_US`)
- `descr.C` — Fallback description (used when locale-specific is not available)
- `descr` — Deprecated in v1.1, no locale support, kept for backward compatibility

Same pattern applies to `value_help.<locale>` and `header.<locale>`.
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