Skip to content

Add documentation sections and fix Parallels Tools sudo elevation#6

Open
DAEMON-404 wants to merge 3 commits into
mainfrom
claude/bspwm-parallels-setup-4q7coq
Open

Add documentation sections and fix Parallels Tools sudo elevation#6
DAEMON-404 wants to merge 3 commits into
mainfrom
claude/bspwm-parallels-setup-4q7coq

Conversation

@DAEMON-404

Copy link
Copy Markdown
Owner

Summary

This PR expands the documentation site with new sections covering the three core engines (arsenal, pentest environment, and Kali hardening), adds styling for keybindings and feature lists, and fixes a critical bug in the Parallels Tools installer where sudo "$0" fails when the script lacks the executable bit.

Key Changes

Documentation & Styling:

  • Added comprehensive "Overview" section explaining the three engines (voidwalker arsenal, pimpmykali, pentest-env)
  • Added "Arsenal" section detailing 400+ tools organized by category (Windows binaries, C# builds, maldev, C2, PowerShell, cross-platform)
  • Added "Rice / Environment" section documenting the BSPWM + zsh + tmux Rosé Pine setup with full keybinding tables
  • Added "Kali Fix" section explaining pimpmykali integration and individual fix flags
  • Added "Parallels Guest" section with step-by-step Parallels Tools installation guide
  • Updated navigation links to reflect new sections and shortened labels
  • Added CSS for <kbd> elements, pill-style badges (.pills), and feature lists (.flist)
  • Added new command deck cards for Shodan and Parallels Tools (pt)

Bug Fix:

  • Fixed parallels-tools.sh sudo elevation: changed exec sudo -E PT_MOUNT="$MOUNT_TARGET" "$0" to exec sudo -E PT_MOUNT="$MOUNT_TARGET" bash "$0" to handle cases where the script is invoked without the executable bit set (e.g., when vendored inside the voidwalker package and run via bash parallels-tools.sh)
  • Added explanatory comment documenting why explicit bash invocation is necessary

Implementation Details

  • The Parallels Tools fix ensures the script can self-elevate regardless of whether it's executable, since sudo "$0" treats a non-executable path as a command name and fails with "command not found", while sudo bash "$0" explicitly invokes the interpreter
  • Documentation uses existing CSS variables and component classes for consistency with the site's Rosé Pine theme
  • All new sections follow the established pattern of .sec containers with .sec__head, .sec__sub, and supporting elements

https://claude.ai/code/session_01QZaFM9UGEhsfHQnrD7HD3m

claude added 3 commits July 2, 2026 16:43
Documents the opt-in pt-install flow (attach CD -> pt-install -> reboot),
what the helper fixes automatically (noexec remount, kernel headers,
libfuse2t64 shim), and the kernel-header abort recovery path.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QZaFM9UGEhsfHQnrD7HD3m
… works

The vendored copy shipped inside the package is mode 644 and voidwalker runs
it as 'bash parallels-tools.sh'. The self-elevation re-exec'd 'sudo -E ... "$0"',
which makes sudo treat the non-executable path as a command and die with
'command not found'. Re-exec through 'bash "$0"' so it works regardless of the
file's exec bit.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QZaFM9UGEhsfHQnrD7HD3m
Adds an overview of the three folded-in engines, an arsenal/categories
section, the full BSPWM rice + zsh/tmux environment (deploy flags, what it
installs, the 'not Starship' prompt note, login steps and a keymap table),
a pimpmykali kali-fix section, pe shell-sugar/fzf widgets, and shodan/pt
command cards. Adds kbd/pill/feature-list styles and the matching nav links.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QZaFM9UGEhsfHQnrD7HD3m
Copilot AI review requested due to automatic review settings July 2, 2026 17:03

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the project’s documentation landing page to describe the “three engines” concept (arsenal, pentest-env, kali hardening), adds a few small UI styles to support those new sections (keycaps/pills/feature lists), and fixes Parallels Tools helper self-elevation so it works even when the script isn’t marked executable (e.g., invoked via bash parallels-tools.sh).

Changes:

  • Fixed Parallels Tools installer self-elevation by re-executing via sudo … bash "$0" instead of sudo … "$0".
  • Expanded docs/index.html with new “overview”, “arsenal”, “rice”, “kali fix”, and “parallels” sections and updated navigation labels/anchors.
  • Added CSS for <kbd>, pill badges, and feature lists used by the new documentation content.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
voidwalker/integrations/assets/pentest-env/config/scripts/parallels-tools.sh Makes sudo self-elevation robust when the script lacks the executable bit by invoking via bash.
docs/index.html Adds new documentation sections, navigation updates, and supporting CSS styles for the docs site.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants