Installation
Ghost currently targets Linux. You need Python 3.10 or newer and Git.
Clone the repository
git clone https://github.com/uatimuu-cmyk/ghost.git
cd ghostCreate a virtual environment
python -m venv .venv
source .venv/bin/activateFor Fish shell, use:
source .venv/bin/activate.fishInstall Ghost
python -m pip install -e .Using Ghost
Run Ghost without arguments to open the home screen:
ghostFor built-in help:
ghost --helpCommands
ghost helpShow the available Ghost commands.
ghost updatesCheck available package updates using pacman. This does not install updates and is intended for Arch-based distributions.
ghost diskDisplay used space, free space, total capacity and usage percentage for your home and root filesystems.
ghost largeSearch your home directory for files of at least 500 MiB. The scan checks up to 12,000 files and displays up to 12 results. It does not delete anything.
ghost vaultDisplay useful Linux commands for inspecting your system. These commands are shown as text and are not executed automatically.
Read-only by design
The current Ghost tools are designed to inspect your system. They do not install packages, delete files, run maintenance operations or execute commands from the vault.
Always inspect a command before choosing to run it yourself.