Black omARCHy host
This machine is Omarchy. Black omARCHy is an additive layer: official
BlackArch repo, curated packages, a thin CLI. It is not a distro, not
Kali, not a fork.
First checks
blackomarchy status
blackomarchy doctor
command -v nmap sqlmap hashcat
If blackomarchy is missing, the layer is not installed. Install from
the Omarchy menu (Install > Black omARCHy) or:
git clone https://github.com/MahdiHedhli/BlackOmarchy.git
cd BlackOmarchy
sudo ./bootstrap.sh
CLI
| Command |
Role |
blackomarchy status |
Repos, version, profiles |
blackomarchy verify |
Omarchy baseline + single [blackarch] |
sudo blackomarchy recapture-baseline |
Refresh the Omarchy pin after install or omarchy update |
blackomarchy doctor |
Hooks, helper, login and Plymouth overlay |
blackomarchy profiles |
Curated profile names |
sudo blackomarchy install <profile> [package] |
core, web, recon, network, wireless, reversing, forensics, password, all, or catalog |
sudo blackomarchy remove <profile> [package] |
Remove packages recorded for that profile |
all means every curated profile, not pacman -S blackarch.
catalog is the BlackArch group, one package at a time, skipping
conflicts. Do not install the blackarch metapackage.
Package lists live in packages/*.txt (installed copy:
/usr/local/share/blackomarchy/packages/). Conflicts are skipped; they
are recorded in /var/lib/blackomarchy/exclusions.
Update path
Keep using omarchy update. With [blackarch] last in pacman.conf,
BlackArch packages update in that pacman -Syu. The post-update hook
then runs blackomarchy-update (git pull + bootstrap). To refresh the
layer alone: blackomarchy update. Do not run a raw pacman -Syu for
the user. Do not set OMARCHY_ALLOW_DIRECT_PACMAN.
If a channel refresh dropped [blackarch], the
pre-refresh-pacman.d / post-update.d hooks re-append it last.
Repair with sudo /usr/local/sbin/blackomarchy-reappend-repo only when
those hooks should have run and the stanza is missing.
Hard rules
- Do not restyle, harden, or replace Omarchy (Hyprland, themes, update
binary, login QML, Plymouth script, keybindings). The login/reboot
wordmark is a reversible
logo.png overlay; blackomarchy-apply-login-branding apply
bakes Plymouth into initramfs. Do not call omarchy plymouth set
(it rewrites Main.qml).
- Do not
apt. This is Arch/Omarchy. Extra packages:
omarchy-pkg-add <name> or sudo blackomarchy install <profile> [package].
- Same-name packages resolve from
core / extra / omarchy first
because [blackarch] is last. That is intentional.
- Do not install
blackarch or blackarch-officials metapackages.
- Offensive work uses the
black-omarchy-pentest skill, which requires
an authorization gate first.
1---2name: black-omarchy3description: Operate a Black omARCHy workstation (Omarchy desktop plus the official BlackArch repository and curated tools). Use when the user mentions Black omARCHy, blackomarchy, BlackArch on Omarchy, installing or removing security profiles, verifying the layer, omarchy update with BlackArch, or asks how this host differs from Kali. Slash: /black-omarchy4---56# Black omARCHy host78This machine is **Omarchy**. Black omARCHy is an additive layer: official9BlackArch repo, curated packages, a thin CLI. It is not a distro, not10Kali, not a fork.1112## First checks1314```bash15blackomarchy status16blackomarchy doctor17command -v nmap sqlmap hashcat18```1920If `blackomarchy` is missing, the layer is not installed. Install from21the Omarchy menu (**Install > Black omARCHy**) or:2223```bash24git clone https://github.com/MahdiHedhli/BlackOmarchy.git25cd BlackOmarchy26sudo ./bootstrap.sh27```2829## CLI3031| Command | Role |32| --- | --- |33| `blackomarchy status` | Repos, version, profiles |34| `blackomarchy verify` | Omarchy baseline + single `[blackarch]` |35| `sudo blackomarchy recapture-baseline` | Refresh the Omarchy pin after install or `omarchy update` |36| `blackomarchy doctor` | Hooks, helper, login and Plymouth overlay |37| `blackomarchy profiles` | Curated profile names |38| `sudo blackomarchy install <profile> [package]` | `core`, `web`, `recon`, `network`, `wireless`, `reversing`, `forensics`, `password`, `all`, or `catalog` |39| `sudo blackomarchy remove <profile> [package]` | Remove packages recorded for that profile |4041`all` means every curated profile, not `pacman -S blackarch`.42`catalog` is the BlackArch group, one package at a time, skipping43conflicts. Do not install the `blackarch` metapackage.4445Package lists live in `packages/*.txt` (installed copy:46`/usr/local/share/blackomarchy/packages/`). Conflicts are skipped; they47are recorded in `/var/lib/blackomarchy/exclusions`.4849## Update path5051Keep using `omarchy update`. With `[blackarch]` last in `pacman.conf`,52BlackArch packages update in that `pacman -Syu`. The post-update hook53then runs `blackomarchy-update` (git pull + bootstrap). To refresh the54layer alone: `blackomarchy update`. Do not run a raw `pacman -Syu` for55the user. Do not set `OMARCHY_ALLOW_DIRECT_PACMAN`.5657If a channel refresh dropped `[blackarch]`, the58`pre-refresh-pacman.d` / `post-update.d` hooks re-append it last.59Repair with `sudo /usr/local/sbin/blackomarchy-reappend-repo` only when60those hooks should have run and the stanza is missing.6162## Hard rules6364- Do not restyle, harden, or replace Omarchy (Hyprland, themes, update65 binary, login QML, Plymouth script, keybindings). The login/reboot66 wordmark is a reversible `logo.png` overlay; `blackomarchy-apply-login-branding apply`67 bakes Plymouth into initramfs. Do not call `omarchy plymouth set`68 (it rewrites Main.qml).69- Do not `apt`. This is Arch/Omarchy. Extra packages:70 `omarchy-pkg-add <name>` or `sudo blackomarchy install <profile> [package]`.71- Same-name packages resolve from `core` / `extra` / `omarchy` first72 because `[blackarch]` is last. That is intentional.73- Do not install `blackarch` or `blackarch-officials` metapackages.74- Offensive work uses the `black-omarchy-pentest` skill, which requires75 an authorization gate first.
MahdiHedhli