romm-cli 1.2.1

Rust-based CLI for the RomM API
Documentation
# Changelog

All notable changes to **romm-cli** are documented in this file.

Entries before the workspace split (1.0.0) are filtered from the unified monolith history by conventional-commit scope. Shared library changes appear in [romm-api/CHANGELOG.md](../romm-api/CHANGELOG.md). Terminal UI changes appear in [romm-tui/CHANGELOG.md](../romm-tui/CHANGELOG.md).

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.2.1]https://github.com/patricksmill/romm-cli/compare/romm-cli-v1.2.0...romm-cli-v1.2.1 (2026-07-20)

## [1.2.0]https://github.com/patricksmill/romm-cli/compare/romm-cli-v1.1.0...romm-cli-v1.2.0 (2026-07-03)


### Features

* **achievements:** integrate RetroAchievements into game detail view ([7a80ed6]https://github.com/patricksmill/romm-cli/commit/7a80ed63ce35b5d5003dd3dbdad7e9c935f8fe16)
* add ROM metadata search, match, and edit ([ba5031e]https://github.com/patricksmill/romm-cli/commit/ba5031e44c3c5cf9cf00e4121b6b283bb2642915)
* **metadata:** add ROM metadata editing functionality to CLI and TUI ([d041ffb]https://github.com/patricksmill/romm-cli/commit/d041ffb0ac57413b533bab9b2a4627c7eaa793c0)
* **metadata:** enhance error handling and metadata application in TUI and API ([9ac601d]https://github.com/patricksmill/romm-cli/commit/9ac601d45e873cdfc4743de2bbe121107fd3c7ac)

## [1.1.0]https://github.com/patricksmill/romm-cli/compare/romm-cli-v1.0.0...romm-cli-v1.1.0 (2026-06-21)


### Features

* **cli:** generate shell completions at runtime only ([af08376]https://github.com/patricksmill/romm-cli/commit/af08376f09e5c8172e69aadfd55345832e3293cb)

## [1.0.0]https://github.com/patricksmill/romm-cli/compare/romm-cli-v0.40.0...romm-cli-v1.0.0 (2026-06-07)

### ⚠ BREAKING CHANGES
* **romm-cli:** removed the `tui` feature and `romm-cli tui` subcommand; the terminal UI ships only as the separate `romm-tui` crate.

### Features
* **romm-cli:** fresh 1.0.0 release after workspace split and TUI decoupling

## [0.39.0]https://github.com/patricksmill/romm-cli/compare/v0.38.0...v0.39.0 (2026-06-06)

### Features
* **cli:** close Gap 7 with CliPresentation and JSON-safe output ([4dcfdad]https://github.com/patricksmill/romm-cli/commit/4dcfdad39d8bf280e1d70b3fa6a2a5d9d54b2781)
* **errors:** implement distinct exit codes for improved error handling ([6d521e7]https://github.com/patricksmill/romm-cli/commit/6d521e7b1f11299c7381385ea955f04dbf21a32a)

## [0.38.0]https://github.com/patricksmill/romm-cli/compare/v0.37.0...v0.38.0 (2026-06-06)

### Features
* **completions:** add shell completion scripts and build script ([f54d761]https://github.com/patricksmill/romm-cli/commit/f54d76119e99694c4ce41797f3b9488a3b4843f8)
* **completions:** enhance shell completion support and CI integration ([9d2db49]https://github.com/patricksmill/romm-cli/commit/9d2db490891ddeca1201c485893f7895da1fb988)

## [0.34.0]https://github.com/patricksmill/romm-cli/compare/v0.33.1...v0.34.0 (2026-05-22)

### Features
* **update:** enhance update process with detailed outcomes and options ([2e11bfc]https://github.com/patricksmill/romm-cli/commit/2e11bfcb894382d8854587ca8751ad4b291e67c3)

## [0.32.0]https://github.com/patricksmill/romm-cli/compare/v0.31.0...v0.32.0 (2026-05-07)

### Features
* add download extras command to fetch covers, manuals, and DLC for games ([11fb0f4]https://github.com/patricksmill/romm-cli/commit/11fb0f4346c755ed44937b02d208cd7a2926b178)

## [0.30.1]https://github.com/patricksmill/romm-cli/compare/v0.30.0...v0.30.1 (2026-05-01)

### Bug Fixes
* **update:** fix redundant update prompt after skipping cli update when running romm-cli tui ([6872855]https://github.com/patricksmill/romm-cli/commit/6872855a5ea05985547e943a63c65bb79dbbaabb)

## [0.29.0]https://github.com/patricksmill/romm-cli/compare/v0.28.0...v0.29.0 (2026-05-01)

### Features
* **update:** enhance update mechanism with dynamic binary name resolution and add tests ([947db3f]https://github.com/patricksmill/romm-cli/commit/947db3f02176359b0be13a924e77b393391d999d)
* **update:** improve binary name extraction from path for better compatibility ([deae08a]https://github.com/patricksmill/romm-cli/commit/deae08abb0cf5863c65149647916aa1bb8724810)

## [0.28.0]https://github.com/patricksmill/romm-cli/compare/v0.27.0...v0.28.0 (2026-04-29)

### Features
* **auth:** add authentication command group to manage credentials ([72b9182]https://github.com/patricksmill/romm-cli/commit/72b9182b439f81e22fc58f67632a3486036a6695)

## [0.26.0]https://github.com/patricksmill/romm-cli/compare/v0.25.0...v0.26.0 (2026-04-27)

### Features
* **update:** add startup update checks and interactive prompt ([e601631]https://github.com/patricksmill/romm-cli/commit/e601631598ed9cf47f4d1abbc51d4fa9ec3d3706)

## [0.25.0]https://github.com/patricksmill/romm-cli/compare/v0.24.0...v0.25.0 (2026-04-21)

### Bug Fixes
* **cli:** fix testing to reflect using --platform instead of --platform-id ([f6ef5b4]https://github.com/patricksmill/romm-cli/commit/f6ef5b47618c2b66f442d4d552559c0428842b2b)

## [0.22.0]https://github.com/patricksmill/romm-cli/compare/v0.21.0...v0.22.0 (2026-04-19)

### Features
* **roms:** implement ROM file upload functionality ([b418c15]https://github.com/patricksmill/romm-cli/commit/b418c1556c894ae1dc9dbdbf23d84dcb8994162f)
* **roms:** implement ROM file upload functionality ([15fc288]https://github.com/patricksmill/romm-cli/commit/15fc288c1394940d46c417b0d9e9c68d329700f5)
* **scan:** add library scan functionality post-ROM upload ([e71855d]https://github.com/patricksmill/romm-cli/commit/e71855d0c8ebeffe89faf67c5f630b7333a42891)
* **scan:** enhance library scan functionality with cache management ([349e316]https://github.com/patricksmill/romm-cli/commit/349e316b1e2c6b0f5035c103de6316aa31db4163)

## [0.21.0]https://github.com/patricksmill/romm-cli/compare/v0.20.0...v0.21.0 (2026-04-19)

### Features
* **cache:** add cache management commands and functionality ([3c99a05]https://github.com/patricksmill/romm-cli/commit/3c99a05c23123326f9f9dfc53fefdfbba32ae58c)

## [0.17.0]https://github.com/patricksmill/romm-cli/compare/v0.16.0...v0.17.0 (2026-04-11)

### Features
* **init:** add non-interactive setup flags for automated configuration ([4bfc8f3]https://github.com/patricksmill/romm-cli/commit/4bfc8f3c54cad769669a67a615d8c900d81a62a5)

## [0.16.0]https://github.com/patricksmill/romm-cli/compare/v0.15.2...v0.16.0 (2026-03-31)

### Features
* **init:** add non-interactive flags for automated setup and browser API token import (`--url`, `--token-file`, `--check`)

## [0.15.0]https://github.com/patricksmill/romm-cli/compare/v0.14.0...v0.15.0 (2026-03-30)

### Features
* overhaul CLI with Resource-Action subcommands and aliases ([90b5c43]https://github.com/patricksmill/romm-cli/commit/90b5c43225a00e91088118ea48427800d9259996)

## [0.14.0]https://github.com/patricksmill/romm-cli/compare/v0.13.1...v0.14.0 (2026-03-30)

### Features
* **cli:** implement ROM and platform API endpoints, services, and CLI commands ([9026a5f]https://github.com/patricksmill/romm-cli/commit/9026a5fd25593e5827ed48422cc79ea8cf6514a7)

## [0.10.0]https://github.com/patricksmill/romm-cli/compare/v0.9.0...v0.10.0 (2026-03-28)

### Features
* Add `init` command for interactive user configuration, including secure credential storage via OS keyring. ([7432a6b]https://github.com/patricksmill/romm-cli/commit/7432a6b98ce7e80d910d72419784b69d8e275cb5)
* Add a self-update command to the CLI, including necessary dependencies and integration into the command structure. ([476bfdf]https://github.com/patricksmill/romm-cli/commit/476bfdff8645074ced5448794ecae22c6b1fabd6)

## [0.6.0]https://github.com/patricksmill/romm-cli/compare/v0.5.0...v0.6.0 (2026-03-27)

### Features
* Add `init` command for interactive user configuration, including secure credential storage via OS keyring. ([7432a6b]https://github.com/patricksmill/romm-cli/commit/7432a6b98ce7e80d910d72419784b69d8e275cb5)
* Add a self-update command to the CLI, including necessary dependencies and integration into the command structure. ([476bfdf]https://github.com/patricksmill/romm-cli/commit/476bfdff8645074ced5448794ecae22c6b1fabd6)

## [0.4.0]https://github.com/patricksmill/romm-cli/compare/v0.3.0...v0.4.0 (2026-03-27)

### Features
* Add `init` command for interactive user configuration, including secure credential storage via OS keyring. ([7432a6b]https://github.com/patricksmill/romm-cli/commit/7432a6b98ce7e80d910d72419784b69d8e275cb5)

## [0.2.0] - 2026-03-20

### Added
- Interactive `romm-cli init` (alias `setup`) to write user config (`API_BASE_URL` and optional auth) under the OS config directory
- `romm-cli init --print-path` and `--force`