Utility Scripts Collection

Personal collection of shell scripts, Python tools, and configuration files accumulated over the years — everything from provisioning a fresh Ubuntu workstation to scraping language-learning resources off the web.

This repo doubles as a Claude Code plugin marketplace. It publishes the tool-permissions PreToolUse hook as the tool-permissions plugin:

claude plugin marketplace add lena-miyamoto/UtilityScripts
claude plugin install tool-permissions@lena-miyamoto

The hook enforces a regex-based allow/ask/deny policy (schema and a full example in agent-templates/claude-global/permissions.json) on every tool call. It requires Python 3.13+ and uv; on first use uv run provisions the virtualenv and downloads rable automatically. The marketplace manifest lives in .claude-plugin/marketplace.json.

The statusline plugin ships the custom Claude Code statusline as stdlib-only Python run through uv — the main bottom bar (model, context bar, git branch/worktree, vim mode, rate limits, cost) plus a per-row subagentStatusLine. Both bars are wired into ~/.claude/settings.json by the bundled install-statusline skill (a plugin cannot enable the main statusLine declaratively).

claude plugin install statusline@lena-miyamoto

ubuntu-setup.sh is the centerpiece. It can take a fresh Ubuntu 24.04 or 26.04 install from stock desktop to a fully configured development and gaming environment in one shot. Two main modes:

• --basic-setup — the essentials (CLI tools, fonts, Flatpak, snap packages, dev toolchains)
• --lenas-setup — everything in --basic-setup plus Godot, Java/Gradle, and other personal preferences

What both modes set up: Flatpak + Flatseal, GNOME Shell preferences, essential CLI tools (curl, jq, rhash, ffmpeg, imagemagick, fish, yt-dlp, eza, bat, difftastic, fd, ripgrep, fzf), system utilities (File Roller, GParted), multimedia codecs, MS Core + proprietary fonts, snap apps (Discord, Spotify, Thunderbird), Firefox ESR (apt, replaces the snap build), Flatpak apps (VLC, Cine, GIMP, Inkscape), Tor Browser, Steam + ProtonUp-Qt, dev toolchains (Python via uv, Rust via rustup, Node via fnm, VS Code), the UFW firewall, and the recommended graphics drivers. All downloads are checksum-verified.

--lenas-setup additionally sets up: KeePassXC, Brave/Edge/Signal, Veracrypt, Podman, gaming launchers and emulators (Heroic, Azahar, Mupen64Plus), custom fonts, Blender + Element, Java/Gradle, and Godot.

Standalone flags — mutually exclusive with the two modes — cover the rest: --install-local-ai (local LLM stack), --install-godot, --install-openssh-server, plus the --configure-* and --reconfigure-* maintenance flags. See Quick start for the full list.

Python scripts for building annotated vocabulary lists across Spanish, English, and German.

Dictionaries scraped: SpanishDict, DixOsola (ES↔DE, ES↔EN), dict.cc, German/English Wiktionary, Oxford Dictionary.

Python scripts for parsing bank account CSV exports (easybank, Sparkasse) and grouping expenses into categories.

# Clone and run
git clone https://github.com/lena-miyamoto/UtilityScripts.git
cd UtilityScripts

# Generic: core tooling and apps
./ubuntu-setup.sh --basic-setup

# Full: adds Godot, Java/Gradle, and personal tweaks
./ubuntu-setup.sh --lenas-setup

The script is designed to be idempotent and safe to re-run.

--basic-setup and --lenas-setup are mutually exclusive. Each standalone --install-* flag is mutually exclusive with both modes, but combinable with the --configure-* / --reconfigure-* flags. --install-openssh-server also requires an existing ~/.ssh/id_ed25519.pub.

WTFPL — Do What The Fuck You Want To Public License v3.