aim/README.md

aim

AppImage Manager

aim is a Rust Cargo workspace for managing AppImages from multiple source types.

Workspace

• crates/aim-core: business logic, source adapters, registry, install/update planning
• crates/aim-cli: thin terminal frontend for parsing, prompting, and rendering

The split is intentional so a future GUI client can reuse aim-core without moving logic out of the shared library.

Commands

aim <QUERY>
aim
aim update
aim list
aim remove <QUERY>

Query Forms

• owner/repo for GitHub shorthand
• GitHub repository URLs
• GitHub release URLs
• direct GitHub release asset URLs
• https://... direct URLs
• GitLab URLs
• file://... local file imports

Scope Overrides

By default aim auto-detects whether to use user or system scope. Override that with:

• --user
• --system

Current Flow Shape

• aim <QUERY> registers unambiguous apps into the registry and renders review prompts when tracking needs confirmation
• bare aim and aim update build a review-first update plan
• aim list renders registered applications
• aim remove <QUERY> resolves a registered application name before removal