# spark-store-cli

**Repository Path**: spark-store-project/spark-store-cli

## Basic Information

- **Project Name**: spark-store-cli
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-08
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# spark-store-cli

`spark-store-cli` launches the storefront TUI by default while keeping the
existing scriptable Spark Store and APM commands available for compatibility.

## Build

```bash
npm install
npm run build
```

## Commands

```bash
spark-store-cli
spark-store-cli ui
spark-store-cli search firefox [--json]
spark-store-cli cli search firefox [--json]
spark-store-cli cli show <pkgname> [--origin spark|apm|both] [--category <name>] [--json]
spark-store-cli cli install <pkgname> [--origin spark|apm|auto] [--category <name>] [-y]
spark-store-cli cli uninstall <pkgname> [--origin spark|apm|auto] [-y]
spark-store-cli cli list installed [--origin spark|apm|both] [--json] [--all-packages]
spark-store-cli cli list upgradable [--origin spark|apm|both] [--json]
spark-store-cli cli update <pkgname> [--origin spark|apm|auto] [-y]
spark-store-cli cli update --all [--origin spark|apm|both] [-y]
```

- `spark-store-cli` launches the storefront TUI.
- `spark-store-cli ui` launches the same storefront TUI explicitly.
- Direct legacy CLI commands such as `spark-store-cli search firefox` remain supported for compatibility.
- `spark-store-cli cli ...` is the explicit scriptable command form.
- TUI V1 includes Home, Browse, Installed, and Updates views.
- TUI actions reuse the existing Spark Store and APM backends.
- Image previews and download queue management are not included in V1.

## Debian Package

```bash
npm run package:deb
sudo dpkg -i artifacts/spark-store-cli_1.0.0_amd64.deb
```

- `npm run package:deb` builds the project and writes a `.deb` package to `artifacts/`.
- Install the package system-wide with `dpkg -i`.
- After install, `spark-store-cli` is available from a normal terminal and launches the storefront TUI by default.

## Package Management Notes

- Write operations use Spark Store's shell-caller where that path is enabled.
- Spark updates bypass shell-caller and fall back to direct root execution or `pkexec`.
- When already running as root, backend commands execute directly.
- Spark local package installs use `ssinstall`.
- Spark repository installs and removals use `aptss`.
- APM app installs bootstrap the `apm` base package when needed.
- APM uninstall uses `apm remove` as the primary semantic.

## Environment

- `SPARK_STORE_BASE_URL`: defaults to `https://erotica.spark-app.store`