AppImage Manager
Find a file
2026-03-19 18:46:50 +00:00
.plans/000-appimage-manager initial skeleton 2026-03-19 18:46:50 +00:00
crates initial skeleton 2026-03-19 18:46:50 +00:00
.gitignore initial skeleton 2026-03-19 18:46:50 +00:00
AGENTS.md initial skeleton 2026-03-19 18:46:50 +00:00
Cargo.lock initial skeleton 2026-03-19 18:46:50 +00:00
Cargo.toml initial skeleton 2026-03-19 18:46:50 +00:00
LICENSE Initial commit 2026-03-19 18:23:56 +00:00
README.md initial skeleton 2026-03-19 18:46:50 +00:00

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
  • 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> resolves the query into a normalized source plan
  • 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