Skip to content
Skills Library
Programming · Automation

pywayne-bin-toolsetup

/pywayne-bin-toolsetup

Configure common development commands and local tool environments with pywayne's toolsetup CLI. Use whenever the user mentions toolsetup, cross-platform shell shortcuts, proxy_on/proxy_off, persistent goto aliases, the Linux gpu helper, nvm/npm bootstrap, Linux Tailscale installation, or MongoDB/PyMongo setup on macOS or Linux—even if they only ask for the right command or a dry-run plan.

Licence
MIT
Last repository change
23.10.2026

Assessment and security

95/ 100Class: good
Format20 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Configure common development commands and local tool environments with pywayne's toolsetup CLI. Use whenever the user mentions toolsetup, cross-platform shell shortcuts, proxy_on/proxy_off, persistent goto aliases, the Linux gpu helper, nvm/npm bootstrap, Linux Tailscale installation, or MongoDB/PyMongo setup on macOS or Linux—even if they only ask for the right command or a dry-run plan.

Original author description

Configure common development commands and local tool environments with pywayne's toolsetup CLI. Use whenever the user mentions toolsetup, cross-platform shell shortcuts, proxy_on/proxy_off, persistent goto aliases, the Linux gpu helper, nvm/npm bootstrap, Linux Tailscale installation, or MongoDB/PyMongo setup on macOS or Linux—even if they only ask for the right command or a dry-run plan.

How it works

  1. Start safely
  2. Support matrix
  3. Shortcut configuration
  4. Node.js and npm
  5. Tailscale on Linux
  6. MongoDB and PyMongo
  7. Verification
  8. Modifying the tool
Original SKILL.md headings · 140 lines, 787 words
SKILL.md preview
---
name: pywayne-bin-toolsetup
description: Configure common development commands and local tool environments with pywayne's toolsetup CLI. Use whenever the user mentions toolsetup, cross-platform shell shortcuts, proxy_on/proxy_off, persistent goto aliases, the Linux gpu helper, nvm/npm bootstrap, Linux Tailscale installation, or MongoDB/PyMongo setup on macOS or Linux—even if they only ask for the right command or a dry-run plan.
---

# Pywayne Bin Toolsetup

Use `toolsetup` as the source of truth for repeatable developer-machine setup. Prefer its task interface over pasting ad-hoc rc snippets or long installer command sequences because it provides platform checks, idempotent managed blocks, confirmation, and dry-run output.

## Start safely

Identify the target platform and requested task, then preview installation work first unless the user explicitly asks you to execute it:

```bash
toolsetup --task <shortcuts|npm|tailscale|mongodb|all> --platform <auto|macos|linux|windows> --dry-run
```

Use `--yes` only when the user has authorized actual installation. npm, Tailscale, and MongoDB may download software and use `sudo`; shortcut-only configuration does not require the confirmation flag.

An explicit platform that differs from the host is accepted only with `--dry-run`. Do not work around that guard.

## Support matrix

| Task | macOS | Linux | Windows |
|---|---|---|---|
| `shortcuts` | bash/zsh | bash/zsh, including `gpu` | PowerShell |
| `npm` | yes | yes | no |
| `tailscale` | no | yes | no |
| `mongodb` | yes | yes | no |

`--task all` selects only tasks supported by the target platform. On Windows this means `shortcuts` only. Do not claim that the `gpu` command is available on macOS or Windows; by design it is Linux-only.

## Shortcut configuration

Use the detected shell, or select it explicitly:

```bash
toolsetup --task shortcuts --platform macos --shell zsh
toolsetup --task shortcuts --platform linux --shell bash
toolsetup.cmd --task shortcuts --platform windows
```

The Unix block provides:

- `proxy_on` / `proxy_off`: toggle HTTP, HTTPS, SOCKS, and NO_PROXY variables and Git global proxy settings.
- `goto`: persist directory shortcuts in `~/.goto_paths`.
- `gpu`: on Linux only, show NVIDIA hardware, compute processes, and VRAM totals by user.

PowerShell provides `proxy_on`, `proxy_off`, and `goto`, storing paths in `~/.goto_paths.json`.

Customize defaults and seed paths with:

```bash
toolsetup --task shortcuts --platform auto \
  --http-proxy http://127.0.0.1:7890 \
  --socks-proxy socks5://127.0.0.1:7890 \
  --no-proxy 'localhost,127.0.0.1,.example.com' \
  --goto code="$HOME/Documents/work/code" \
  --goto tools="$HOME/Documents/tools"
```

The shortcut block is enclosed by `pywayne toolsetup shortcuts` markers. If it already exists, the tool skips it. Use `--force` only when the user asks to refresh the managed block; replacement creates a timestamped rc-file backup.

After configuration, reload Unix with the exact `source <profile>` command printed by the tool. Reload PowerShell with:

```powershell
. $PROFILE
```

Common `goto` commands are `goto add <key> <path>`, `goto list`, `goto <key>`, `goto remove <key>`, and `goto clear`.

## Node.js and npm

```bash
toolsetup --task npm --platform linux --dry-run
toolsetup --task npm --platform linux --yes
toolsetup --task npm --platform macos --node-version 24 --yes
```

Defaults are nvm `v0.40.6`, Node.js `20`, and `https://registry.npmmirror.com`. Override them with `--nvm-version`, `--node-version`, and `--npm-registry`.

Linux installs prerequisites through apt, dnf, yum, zypper, or apk. macOS requires Xcode Command Line Tools. nvm is installed with its official installer rather than Homebrew, then the task lists LTS versions, installs the selected Node version, sets the default alias, and saves the npm registry.

## Tailscale on Linux

```bash
toolsetup --task tailscale --platform linux --dry-run
toolsetup --task tailscale --platform linux --yes
```

The task runs the official Linux installer, enables `tailscaled` when systemd is active, and runs `sudo tailscale up`. Explain that first use normally prints an authentication URL. Do not suggest this task for macOS or Windows; those platforms are intentionally outside its scope.

## MongoDB and PyMongo

```bash
toolsetup --task mongodb --platform macos --dry-run
toolsetup --task mongodb --platform macos --yes
toolsetup --task mongodb --platform linux --yes
```

The verified server line is MongoDB 8.0:

- macOS uses the official `mongodb/brew` tap and starts `mongodb-community@8.0` with `brew services`.
- Ubuntu 20.04/22.04/24.04 and Debian 12 use the official apt repository.
- RHEL-compatible distributions 8/9 use the official yum/dnf repository.
- Linux enables and starts `mongod` with systemd.

PyMongo is installed into `~/.venvs/pywayne-mongodb` by default. Use `--pymongo-venv <path>` to change it or `--skip-pymongo` to install only the server. The tool deliberately stops when the distro-provided Debian/Ubuntu `mongodb` package conflicts with `mongodb-org`; never remove that package or its data without explicit user direction.

## Verification

Use checks appropriate to the completed task:

```bash
node -v
npm -v
npm config get registry
tailscale status
systemctl status mongod
brew services list
~/.venvs/pywayne-mongodb/bin/python -c "import pymongo; print(pymongo.version)"
```

For MongoDB exposed beyond localhost, remind the user that authentication, TLS, firewall rules, and backups are separate production concerns.

## Modifying the tool

When the user asks to change implementation rather than use it, inspect these files:

- `bin/toolsetup.py`: CLI, templates, and task implementations.
- `bin/toolsetup`, `bin/toolsetup.cmd`: POSIX and Windows launchers.
- `docs/source/bin/toolsetup.rst`: user documentation.
- `setup.py` and `docs/source/index.rst`: packaging and documentation registration.

After editing, run:

```bash
python3 -m py_compile bin/toolsetup.py
git diff --check
cd docs && make html SPHINXOPTS=-W
```

Do not run actual installers as a test. Validate installation paths with `--dry-run` for Linux, macOS, and Windows.
Files in this package (2)
  • SKILL.md 6 KB
  • evals/evals.json 2 KB

Versions

The database has no other skills named pywayne-bin-toolsetup.

Database snapshot: 13.11.2026 · package version 83eb81d86462 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 98shell-shortcuts
    Configure cross-platform terminal shortcut commands on a new machine, including proxy_on/proxy_off (env vars + git global proxy), goto (persistent path jump shortcuts), gpu (nvidia-smi helper), and optional Conda auto-activation. Use when setting up Windows PowerShell Profile /…
  • 95pywayne-bin-cmdlogger
    Execute commands with full I/O logging. Use when users need to record the complete execution of a command including stdin, stdout, and stderr to a log file while maintaining real-time console output. Triggered by requests to log, record, monitor, or trace command execution,…
  • 95bash-linux
    Bash and Linux/macOS shell patterns - operators, files, processes, text tools, scripts. Use for shell work on Unix.
  • 95glab-alias
    Create, list, and delete GitLab CLI command aliases and shortcuts. Use when creating custom glab commands, managing CLI shortcuts, or viewing existing aliases. Triggers on alias, shortcut, custom command, CLI alias.
  • 90hogli
    PostHog developer CLI and repo tooling reference. Use when the user mentions hogli, asks about repo CLI tools, bin scripts, Makefiles, how to run/build/test/lint, or any dev environment commands.
  • 100bash-linux
    Bash/Linux terminal patterns. Critical commands, piping, error handling, scripting. Use when working on macOS or Linux systems.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.