Oni-Ofix 🚀

Oni-Ofix is a lightweight, dependency-free command-line utility designed to handle multi-platform package installations and distributions for Jarvis. It acts as a direct user-space package installer for Linux, Windows, and Android (no administrative or sudo privileges required).

Features

• 📱 Android (-a / --android): Automates installing APKs on one or more connected physical or virtual Android devices via ADB.
• 🐧 Linux (-l / --linux): Installs application folders directly into user-space (~/.local/share/), registers launcher shell commands in ~/.local/bin/, and creates system desktop application shortcuts.
• 🪟 Windows (-w / --windows): If run on Windows, performs local installation in %LOCALAPPDATA% and creates desktop shortcuts. If run on a non-Windows OS, generates a folder package with a standalone PowerShell installation script (install.ps1) to be executed on Windows with one click.

Installation

Once published to npm, you can install the CLI tool globally:

npm install -g oni-ofix-cli

Note: The package name on npm is oni-ofix-cli to bypass naming conflicts, but the commands registered are oni-ofix and ofix.

For development and local testing, run inside the repository:

node bin/index.js [flags]

Usage & Flags

1. Install an APK on Android

Connect your phone with USB Debugging enabled, then run:

oni-ofix -a /path/to/your/app.apk
# or
ofix -a /path/to/your/app.apk

Oni-Ofix will auto-detect all connected devices and install the APK on all of them in parallel.

2. Install a Linux Application (Local User Space)

Install a directory containing application source files directly onto your local Linux system:

ofix -l /path/to/app/source/dir

Oni-Ofix will prompt you for the Application Name, Version, Executable path, and Description. It copies the files, links them in ~/.local/bin/ and creates a desktop menu shortcut. No sudo is required.

3. Install/Package a Windows Application (Local User Space)

Install application folders natively or package them for Windows distribution:

ofix -w /path/to/app/source/dir

If run on Windows, it installs the app to %LOCALAPPDATA% and creates a shortcut. If run on Linux, it outputs an installer payload directory and an install.ps1 PowerShell script in the dist/ directory, which can be run on Windows to install it with one click.

🔒 Confidentiality & Local Runs

No telemetry or external tracking. Oni-Ofix runs completely locally on your system.