jira alias import¶
- Usage:
jira alias import [FILENAME|-] [flags]
Read alias definitions from a YAML map and merge them into the active config file. Use it to share a team alias set or restore aliases from a backup.
Existing aliases are kept unless --clobber is set. Each imported expansion is validated against built-in commands or aliases already present in config; invalid entries are skipped and reported.
Safety¶
--clobber¶
Overwrite existing aliases of the same name
--dry-run¶
Validate and preview the merge without writing the config file
Output fields¶
With --output json, the response envelope's data object carries these fields. Run jira agent schema for the full machine-readable schema.
| Field | Type | Description |
|---|---|---|
aliases[] |
string | |
dry_run |
boolean | |
imported |
integer | |
skipped |
object | null |
Examples¶
jira alias import aliases.yaml
jira alias import - --clobber # (1)!
jira --config team-jira.yaml alias import aliases.yaml # (2)!
- Read YAML from stdin and replace existing names
- Import into a non-default config file