aim/README.md
2026-03-19 18:46:50 +00:00

42 lines
1 KiB
Markdown

# 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
```text
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