stoorps/aim
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
AppImage Manager
8 commits 2 branches 0 tags 386 KiB
Find a file
stoorps 8c4d6859ae
feat: add update execution and provider contract design and implementation plans
2026-03-20 00:15:02 +00:00
.plans feat: add update execution and provider contract design and implementation plans 2026-03-20 00:15:02 +00:00
crates feat: implement uninstall functionality for managed artifacts and persist install metadata 2026-03-19 23:07:25 +00:00
.gitignore feat: enhance .gitignore and add per-distro installation design and implementation plans 2026-03-19 21:10:33 +00:00
AGENTS.md initial skeleton 2026-03-19 18:46:50 +00:00
Cargo.lock Implement per-distro installation flow 2026-03-19 21:59:18 +00:00
Cargo.toml Implement per-distro installation flow 2026-03-19 21:59:18 +00:00
LICENSE Initial commit 2026-03-19 18:23:56 +00:00
README.md Implement per-distro installation flow 2026-03-19 21:59:18 +00:00

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> installs unambiguous apps, persists them into the registry after successful install, 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