packages.json

[
  {
    "name": "zsh",
    "tags": ["terminal"],
    "package_manager": { "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "high",
    "optional": false,
    "description": "Z shell — common shell across all devices; install first so plugins are available"
  },
  {
    "name": "zsh-antidote",
    "tags": ["terminal"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "macos_name": "antidote",
    "priority": "high",
    "optional": false,
    "description": "Lightweight zsh plugin manager — handles autosuggestions, syntax highlighting, completions, substring search, and abbreviations via a plugins file"
  },
  {
    "name": "zoxide",
    "tags": ["terminal"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay" },
    "priority": "high",
    "optional": false,
    "description": "Smarter cd — learns your frequent directories, use z to jump instantly"
  },
  {
    "name": "expat",
    "tags": ["development"],
    "package_manager": { "macos": "brew" },
    "priority": "high",
    "optional": false,
    "description": "XML parsing library — required for pyenv to compile Python correctly on macOS Tahoe"
  },
  {
    "name": "pyenv",
    "tags": ["development"],
    "package_manager": { "macos": "brew", "ubuntu": "custom", "arch": "custom" },
    "priority": "high",
    "optional": false,
    "handled_by_setup": true,
    "install_command": "curl https://pyenv.run | bash",
    "description": "Python version manager — compiles from source to avoid distro-packaged Python quirks and broken Homebrew bottles on macOS Tahoe"
  },
  {
    "name": "nvm",
    "tags": ["development"],
    "package_manager": { "macos": "custom", "ubuntu": "custom", "arch": "custom", "server": "custom" },
    "priority": "high",
    "optional": false,
    "handled_by_setup": true,
    "install_command": "curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash",
    "description": "Node version manager — installed via curl per nvm recommendation; brew install causes PATH issues"
  },
  {
    "name": "pipx",
    "tags": ["development"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay" },
    "arch_name": "python-pipx",
    "priority": "high",
    "optional": false,
    "description": "Installs Python CLI tools in isolated virtual environments"
  },
  {
    "name": "uv",
    "tags": ["development"],
    "package_manager": { "macos": "brew", "ubuntu": "pipx", "arch": "yay" },
    "priority": "high",
    "optional": false,
    "description": "Fast Python package and project manager — pip/venv/pyenv successor"
  },
  {
    "name": "build-essential",
    "tags": ["development"],
    "package_manager": { "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "arch_name": "base-devel",
    "priority": "high",
    "optional": false,
    "description": "Compiler toolchain — gcc, make, etc.; required for pyenv, native Node modules, AUR builds, and cargo install (e.g. railguard)"
  },
  {
    "name": "git",
    "tags": ["development"],
    "package_manager": { "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": { "ubuntu": "high", "arch": "high", "server": "medium" },
    "optional": false,
    "description": "Version control — usually pre-installed but listed to ensure it's present"
  },
  {
    "name": "rust",
    "tags": ["development"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "ubuntu_name": "rustup",
    "arch_name": "rustup",
    "server_name": "rustup",
    "priority": "medium",
    "optional": false,
    "description": "Rust toolchain — rustup on Linux (distro rustc goes stale; setup runs 'rustup default stable'), plain rust formula on macOS"
  },
  {
    "name": "go",
    "tags": ["development"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay" },
    "ubuntu_name": "golang-go",
    "priority": "medium",
    "optional": false,
    "description": "Go toolchain"
  },
  {
    "name": "ghostty",
    "tags": ["terminal"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "snap", "arch": "yay" },
    "priority": "medium",
    "optional": false,
    "install_command": "sudo snap install ghostty --classic",
    "description": "GPU-accelerated terminal emulator — requires --classic on snap for full system access"
  },
  {
    "name": "fastfetch",
    "tags": ["terminal", "system-monitoring"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "Fast system info display — shown on terminal startup; Ubuntu needs the fastfetch PPA (setup adds it)"
  },
  {
    "name": "gh",
    "tags": ["development"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "arch_name": "github-cli",
    "priority": "medium",
    "optional": false,
    "description": "GitHub CLI — PRs, issues, Actions from the terminal; apt platforms use the GitHub CLI apt repo (setup adds it)"
  },
  {
    "name": "forgejo-cli",
    "tags": ["development"],
    "package_manager": { "macos": "brew", "ubuntu": "custom", "arch": "custom" },
    "priority": "medium",
    "optional": false,
    "install_command": "cargo install forgejo-cli",
    "description": "Forgejo CLI (fj) — PRs, issues, releases against the self-hosted Forgejo instance; no Linux package, cargo is the upstream install path"
  },
  {
    "name": "git-lfs",
    "tags": ["development"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "Git extension for versioning large binary files"
  },
  {
    "name": "git-xet",
    "tags": ["development", "local-llm"],
    "package_manager": { "macos": "brew", "ubuntu": "custom", "arch": "custom" },
    "priority": "medium",
    "optional": false,
    "environment": { "ubuntu": ["personal"], "arch": ["personal"] },
    "install_command": "curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/huggingface/xet-core/refs/heads/main/git_xet/install.sh | sh",
    "description": "Git LFS plugin using the Xet protocol for Hugging Face Hub"
  },
  {
    "name": "pre-commit",
    "tags": ["development"],
    "package_manager": { "ubuntu": "pipx", "arch": "yay" },
    "priority": "medium",
    "optional": false,
    "description": "Git pre-commit hook framework — runs this repo's shellcheck, JSON, and zsh syntax checks before each commit"
  },
  {
    "name": "shellcheck",
    "tags": ["development"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "Static analysis linter for shell scripts — used by the pre-commit config and CI"
  },
  {
    "name": "codespell",
    "tags": ["development"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay" },
    "priority": "medium",
    "optional": false,
    "description": "Spell checker for source code — catches common misspellings in identifiers, comments, and docs"
  },
  {
    "name": "pytest",
    "tags": ["development"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "ubuntu_name": "python3-pytest",
    "arch_name": "python-pytest",
    "server_name": "python3-pytest",
    "priority": "medium",
    "optional": false,
    "description": "Python testing framework — used by the post-test-runner.sh hook to auto-run test suites in Python projects"
  },
  {
    "name": "swiftlint",
    "tags": ["development"],
    "package_manager": { "macos": "brew" },
    "priority": "medium",
    "optional": false,
    "description": "Swift linter — Swift development is macOS-only"
  },
  {
    "name": "swiftformat",
    "tags": ["development"],
    "package_manager": { "macos": "brew" },
    "priority": "medium",
    "optional": false,
    "description": "Swift code formatter — pairs with swiftlint"
  },
  {
    "name": "xcodegen",
    "tags": ["development"],
    "package_manager": { "macos": "brew" },
    "priority": "medium",
    "optional": false,
    "description": "Generates Xcode project files from a YAML/JSON spec — Xcode tooling is macOS-only"
  },
  {
    "name": "gnupg",
    "tags": ["security"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "GPG — required for commit signing"
  },
  {
    "name": "hf",
    "tags": ["local-llm"],
    "package_manager": { "macos": "brew", "ubuntu": "pipx", "arch": "pipx" },
    "priority": "medium",
    "optional": false,
    "environment": { "ubuntu": ["personal"], "arch": ["personal"] },
    "install_command": { "ubuntu": "pipx install huggingface-hub[cli]", "arch": "pipx install huggingface-hub[cli]" },
    "description": "Hugging Face Hub CLI — download, upload, and manage ML models"
  },
  {
    "name": "htop",
    "tags": ["system-monitoring"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "Interactive process viewer — colorized alternative to top"
  },
  {
    "name": "llama.cpp",
    "tags": ["local-llm"],
    "package_manager": { "macos": "brew", "ubuntu": "custom", "arch": "yay" },
    "priority": { "macos": "medium", "ubuntu": "none", "arch": "none" },
    "optional": { "macos": false, "ubuntu": true, "arch": true },
    "install_command": { "ubuntu": "See https://github.com/ggml-org/llama.cpp#build" },
    "description": "LLM inference engine — run local models on CPU and Apple Silicon GPU"
  },
  {
    "name": "mlx-lm",
    "tags": ["local-llm"],
    "package_manager": { "macos": "brew" },
    "priority": "medium",
    "optional": false,
    "description": "Run and fine-tune LLMs with Apple MLX on Apple silicon"
  },
  {
    "name": "mactop",
    "tags": ["system-monitoring"],
    "package_manager": { "macos": "brew" },
    "priority": "medium",
    "optional": false,
    "description": "Apple Silicon system monitor — CPU, GPU, ANE, memory, power in real-time TUI"
  },
  {
    "name": "micro",
    "tags": ["terminal"],
    "package_manager": { "macos": "brew", "ubuntu": "snap", "arch": "yay", "server": "snap" },
    "priority": "medium",
    "optional": false,
    "install_command": "sudo snap install micro --classic",
    "description": "Modern terminal text editor — snap on noble platforms (apt is stuck at 2.0.13; upstream guarantees latest via snap)"
  },
  {
    "name": "nvtop",
    "tags": ["system-monitoring"],
    "package_manager": { "macos": "brew", "ubuntu": "snap", "arch": "yay", "server": "snap" },
    "priority": "medium",
    "optional": false,
    "description": "GPU process monitor — complements htop with GPU visibility"
  },
  {
    "name": "lact",
    "tags": ["system-monitoring"],
    "package_manager": { "arch": "yay" },
    "priority": "medium",
    "optional": false,
    "description": "Linux AMD GPU control panel — fan curves, voltage offset, power cap, clock limits via GUI + background daemon; see linux-desktop/lact_r9700_tuning.md for R9700 config"
  },
  {
    "name": "sshpass",
    "tags": ["networking"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "Non-interactive SSH password authentication — used by SSH_and_GPG/add_remote_host.sh"
  },
  {
    "name": "tmux",
    "tags": ["terminal"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "Terminal multiplexer — split panes, persist sessions across disconnects"
  },
  {
    "name": "eza",
    "tags": ["terminal"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "Modern ls replacement — colors, icons, git status, tree view; Ubuntu needs the eza community apt repo (setup adds it)"
  },
  {
    "name": "terminal-notifier",
    "tags": ["desktop-utility"],
    "package_manager": { "macos": "brew" },
    "priority": "medium",
    "optional": false,
    "description": "macOS notification CLI — backend for the zshrc long-command notify hook (Linux uses notify-send)"
  },
  {
    "name": "fzf",
    "tags": ["terminal"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "Fuzzy finder — Ctrl+R history search, Ctrl+T file search"
  },
  {
    "name": "ripgrep",
    "tags": ["terminal"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "Fast recursive grep replacement — command: rg"
  },
  {
    "name": "bat",
    "tags": ["terminal"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "cat with syntax highlighting and git integration — Ubuntu installs binary as batcat (setup symlinks bat)"
  },
  {
    "name": "fd",
    "tags": ["terminal"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "ubuntu_name": "fd-find",
    "server_name": "fd-find",
    "priority": "medium",
    "optional": false,
    "description": "Fast find alternative — Ubuntu installs binary as fdfind (setup symlinks fd)"
  },
  {
    "name": "jq",
    "tags": ["development"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": { "macos": "low", "ubuntu": "medium", "arch": "medium", "server": "medium" },
    "optional": { "macos": true, "ubuntu": false, "arch": false, "server": false },
    "description": "JSON processor — required by setup.sh to parse this file; system-provided on macOS so the brew build is low-priority/optional there"
  },
  {
    "name": "curl",
    "tags": ["networking"],
    "package_manager": { "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "HTTP client — usually pre-installed; required by various install scripts"
  },
  {
    "name": "wget",
    "tags": ["networking"],
    "package_manager": { "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "HTTP file downloader — used by setup scripts for key imports"
  },
  {
    "name": "libnotify-bin",
    "tags": ["desktop-utility"],
    "package_manager": { "ubuntu": "apt", "arch": "yay" },
    "arch_name": "libnotify",
    "priority": "medium",
    "optional": false,
    "description": "Desktop notifications CLI (notify-send) — backend for the zshrc long-command notify hook"
  },
  {
    "name": "ncdu",
    "tags": ["system-monitoring"],
    "package_manager": { "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "Interactive disk usage analyzer — essential for managing storage on a file server"
  },
  {
    "name": "cockpit",
    "tags": ["system-monitoring", "networking"],
    "package_manager": { "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "Web-based server admin UI — system metrics, journal logs, network config, storage, and service management; access at https://<server-ip>:9090"
  },
  {
    "name": "nut",
    "tags": ["system-monitoring"],
    "package_manager": { "server": "apt" },
    "priority": "medium",
    "optional": false,
    "description": "Network UPS Tools — monitors the CyberPower CST135UC2 over USB (usbhid-ups, standalone); graceful shutdown on low battery; configure via linux-server/ups/setup.sh"
  },
  {
    "name": "tailscale",
    "tags": ["networking"],
    "package_manager": { "macos": "app-store", "ubuntu": "custom", "arch": "yay", "server": "custom" },
    "macos_name": "Tailscale",
    "priority": "medium",
    "optional": false,
    "install_command": "curl -fsSL https://tailscale.com/install.sh | sudo sh",
    "handled_by_setup": true,
    "description": "Zero-config VPN — access all devices on a private network; App Store version required on macOS for network extension entitlements"
  },
  {
    "name": "docker",
    "tags": ["development", "containers"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "custom", "arch": "yay", "server": "custom" },
    "macos_name": "docker-desktop",
    "priority": "low",
    "optional": true,
    "handled_by_setup": true,
    "install_command": "curl -fsSL https://get.docker.com | sudo sh",
    "description": "Container platform — Docker Desktop on macOS, official Docker Engine on Linux"
  },
  {
    "name": "claude-code",
    "tags": ["ai-coding"],
    "package_manager": { "macos": "custom", "ubuntu": "custom", "arch": "custom", "server": "custom" },
    "priority": "medium",
    "optional": false,
    "handled_by_setup": true,
    "install_command": "curl -fsSL https://claude.ai/install.sh | bash",
    "description": "Claude Code — terminal-based AI coding assistant"
  },
  {
    "name": "opencode",
    "tags": ["ai-coding"],
    "package_manager": { "macos": "brew", "ubuntu": "custom", "arch": "yay" },
    "macos_name": "anomalyco/tap/opencode",
    "arch_name": "opencode-bin",
    "priority": "medium",
    "optional": false,
    "install_command": { "ubuntu": "curl -fsSL https://opencode.ai/install | bash" },
    "description": "Terminal-based AI coding agent — brew installs from the anomalyco tap"
  },
  {
    "name": "claude-desktop",
    "tags": ["ai-coding"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "custom", "arch": "yay" },
    "macos_name": "claude",
    "arch_name": "claude-desktop-bin",
    "priority": "medium",
    "optional": false,
    "install_command": "curl -fsSL https://pkg.claude-desktop-debian.dev/KEY.gpg | sudo gpg --dearmor -o /usr/share/keyrings/claude-desktop.gpg && echo 'deb [signed-by=/usr/share/keyrings/claude-desktop.gpg arch=amd64,arm64] https://pkg.claude-desktop-debian.dev stable main' | sudo tee /etc/apt/sources.list.d/claude-desktop.list && sudo apt update && sudo apt install -y claude-desktop",
    "description": "Anthropic Claude desktop app — Ubuntu uses aaddrick/claude-desktop-debian apt repo"
  },
  {
    "name": "visual-studio-code",
    "tags": ["development"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "snap", "arch": "yay" },
    "ubuntu_name": "code",
    "arch_name": "visual-studio-code-bin",
    "priority": "medium",
    "optional": false,
    "install_command": "sudo snap install code --classic",
    "description": "Code editor with extensions — requires --classic on snap"
  },
  {
    "name": "firefox",
    "tags": ["browser"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "snap", "arch": "yay" },
    "priority": "medium",
    "optional": false,
    "description": "Open source web browser"
  },
  {
    "name": "zen-browser",
    "tags": ["browser"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "custom", "arch": "yay" },
    "macos_name": "zen",
    "arch_name": "zen-browser-bin",
    "priority": "medium",
    "optional": false,
    "install_command": { "ubuntu": "flatpak install flathub app.zen_browser.zen" },
    "description": "Firefox-based browser focused on privacy and a calmer UI — no Ubuntu snap/apt package, flatpak is the upstream install path"
  },
  {
    "name": "chromium",
    "tags": ["browser"],
    "package_manager": { "ubuntu": "snap", "arch": "yay" },
    "priority": "medium",
    "optional": false,
    "environment": ["work"],
    "description": "Open source Chromium browser — used for work alongside Firefox"
  },
  {
    "name": "obs-studio",
    "tags": ["media"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "apt", "arch": "yay" },
    "macos_name": "obs",
    "priority": "medium",
    "optional": false,
    "description": "Open source broadcasting and screen recording"
  },
  {
    "name": "vlc",
    "tags": ["media"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "apt", "arch": "yay" },
    "priority": "medium",
    "optional": false,
    "description": "Open source media player for nearly every format"
  },
  {
    "name": "discord",
    "tags": ["communication", "entertainment"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "snap", "arch": "yay" },
    "priority": "medium",
    "optional": false,
    "environment": { "ubuntu": ["personal"], "arch": ["personal"] },
    "description": "Voice, video, and text chat platform"
  },
  {
    "name": "bitwarden",
    "tags": ["security"],
    "package_manager": { "macos": "app-store", "ubuntu": "snap", "arch": "yay" },
    "macos_name": "Bitwarden",
    "priority": "medium",
    "optional": false,
    "description": "Open source password manager — App Store version required on macOS for browser integration"
  },
  {
    "name": "slack",
    "tags": ["communication"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "snap", "arch": "yay" },
    "arch_name": "slack-desktop",
    "priority": "medium",
    "optional": false,
    "environment": ["work"],
    "description": "Team messaging and collaboration"
  },
  {
    "name": "zoom",
    "tags": ["communication"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "snap", "arch": "yay" },
    "ubuntu_name": "zoom-client",
    "priority": "medium",
    "optional": false,
    "environment": ["work"],
    "description": "Video conferencing"
  },
  {
    "name": "microsoft-outlook",
    "tags": ["communication"],
    "package_manager": { "macos": "brew-cask" },
    "priority": "medium",
    "optional": false,
    "environment": ["work"],
    "description": "Email client for Microsoft 365"
  },
  {
    "name": "teams-for-linux",
    "tags": ["communication"],
    "package_manager": { "ubuntu": "snap", "arch": "yay" },
    "priority": "medium",
    "optional": false,
    "environment": ["work"],
    "description": "Unofficial Microsoft Teams client for Linux"
  },
  {
    "name": "codeburn",
    "tags": ["development", "ai-coding"],
    "package_manager": { "macos": "pnpm", "ubuntu": "pnpm", "arch": "pnpm" },
    "priority": "medium",
    "optional": false,
    "description": "Track AI coding token usage by task, tool, model, and project"
  },
  {
    "name": "codeburn-menubar",
    "tags": ["development", "ai-coding"],
    "package_manager": { "macos": "custom" },
    "handled_by_setup": false,
    "install_command": "codeburn menubar",
    "priority": "none",
    "optional": false,
    "description": "codeburn menu-bar companion app — currently buggy upstream, run only if you want it (needs the codeburn pnpm package)"
  },
  {
    "name": "mac-mouse-fix",
    "tags": ["desktop-utility"],
    "package_manager": { "macos": "brew-cask" },
    "priority": "medium",
    "optional": false,
    "description": "Decouples mouse scroll speed from trackpad settings"
  },
  {
    "name": "rectangle",
    "tags": ["desktop-utility"],
    "package_manager": { "macos": "brew-cask" },
    "priority": "medium",
    "optional": false,
    "description": "Open source window management"
  },
  {
    "name": "caffeine",
    "tags": ["desktop-utility"],
    "package_manager": { "macos": "brew-cask" },
    "priority": "medium",
    "optional": false,
    "description": "Simple menubar toggle to keep Mac awake"
  },
  {
    "name": "stats",
    "tags": ["system-monitoring", "desktop-utility"],
    "package_manager": { "macos": "brew-cask" },
    "priority": "medium",
    "optional": false,
    "description": "macOS menubar system monitor for CPU, GPU, memory, network, and disk"
  },
  {
    "name": "google-drive",
    "tags": ["cloud-storage"],
    "package_manager": { "macos": "brew-cask" },
    "priority": "medium",
    "optional": false,
    "description": "Google Drive desktop client"
  },
  {
    "name": "amazon-photos",
    "tags": ["photos", "cloud-storage"],
    "package_manager": { "macos": "brew-cask" },
    "priority": "medium",
    "optional": false,
    "description": "Unlimited full-resolution photo backup for Amazon Prime members"
  },
  {
    "name": "notion",
    "tags": ["productivity"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "snap", "arch": "yay" },
    "ubuntu_name": "notion-snap-reborn",
    "arch_name": "notion-app-electron",
    "priority": { "macos": "medium", "ubuntu": "low", "arch": "low" },
    "optional": { "macos": false, "ubuntu": true, "arch": true },
    "environment": { "ubuntu": ["personal"], "arch": ["personal"] },
    "description": "Notes and project management — unofficial snap/AUR packages on Linux"
  },
  {
    "name": "obsidian",
    "tags": ["productivity"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "snap", "arch": "yay" },
    "priority": "medium",
    "optional": false,
    "install_command": "sudo snap install obsidian --classic",
    "description": "Markdown knowledge base — official snap requires --classic for vault access"
  },
  {
    "name": "anki",
    "tags": ["productivity"],
    "package_manager": { "macos": "brew-cask", "ubuntu": "custom", "arch": "yay" },
    "priority": "medium",
    "optional": false,
    "install_command": { "ubuntu": "Download the installer from https://apps.ankiweb.net (apt's anki is years stale)" },
    "description": "Spaced-repetition flashcards"
  },
  {
    "name": "Spark Mail – AI Email Inbox",
    "tags": ["communication"],
    "macos_name": "Spark Desktop",
    "package_manager": { "macos": "app-store" },
    "priority": "medium",
    "optional": false,
    "description": "Smart email client with AI features"
  },
  {
    "name": "Photomator",
    "tags": ["photos"],
    "package_manager": { "macos": "app-store" },
    "priority": "medium",
    "optional": false,
    "description": "Photo editor — free version with pay-once upgrade"
  },
  {
    "name": "net-tools",
    "tags": ["networking"],
    "package_manager": { "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "low",
    "optional": true,
    "description": "Legacy network utilities — ifconfig, netstat, route"
  },
  {
    "name": "poppler",
    "tags": ["media"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay" },
    "ubuntu_name": "poppler-utils",
    "priority": "low",
    "optional": true,
    "description": "PDF CLI tools — pdftotext, pdfimages, pdfinfo, pdftoppm"
  },
  {
    "name": "ffmpeg",
    "tags": ["media"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "low",
    "optional": true,
    "description": "Audio/video processing toolkit"
  },
  {
    "name": "exiftool",
    "tags": ["media", "photos"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "ubuntu_name": "libimage-exiftool-perl",
    "arch_name": "perl-image-exiftool",
    "server_name": "libimage-exiftool-perl",
    "priority": "low",
    "optional": true,
    "description": "Read and write metadata in photos, videos, and other files"
  },
  {
    "name": "tesseract",
    "tags": ["media"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay" },
    "ubuntu_name": "tesseract-ocr",
    "priority": "low",
    "optional": true,
    "description": "OCR engine — extract text from images and scanned documents"
  },
  {
    "name": "fio",
    "tags": ["benchmarking"],
    "package_manager": { "macos": "brew" },
    "priority": "low",
    "optional": true,
    "description": "Storage I/O benchmark — sequential and random IOPS; used by macOS/benchmarks/"
  },
  {
    "name": "hyperfine",
    "tags": ["benchmarking"],
    "package_manager": { "macos": "brew" },
    "priority": "low",
    "optional": true,
    "description": "Command-line benchmarking tool with warmup, N runs, and JSON export"
  },
  {
    "name": "smartmontools",
    "tags": ["system-monitoring"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "low",
    "optional": true,
    "description": "Monitor SSD/HDD health via S.M.A.R.T. data — use: smartctl -a /dev/sdX"
  },
  {
    "name": "stress-ng",
    "tags": ["benchmarking"],
    "package_manager": { "macos": "brew" },
    "priority": "low",
    "optional": true,
    "description": "CPU/memory stress tester — STREAM memory bandwidth; used by macOS/benchmarks/"
  },
  {
    "name": "geekbench",
    "tags": ["benchmarking"],
    "package_manager": { "macos": "brew-cask" },
    "priority": "low",
    "optional": true,
    "description": "Geekbench 6 — standardized CPU + Metal GPU benchmark; used by macOS/benchmarks/standardized.sh"
  },
  {
    "name": "geekbench-ai",
    "tags": ["benchmarking"],
    "package_manager": { "macos": "brew-cask" },
    "priority": "low",
    "optional": true,
    "description": "Geekbench AI — standardized ML inference benchmark (Core ML / Metal / ANE); used by macOS/benchmarks/standardized.sh"
  },
  {
    "name": "cinebench",
    "tags": ["benchmarking"],
    "package_manager": { "macos": "custom" },
    "install_command": "bash \"$SETUP_ROOT/macOS/install-cinebench.sh\"",
    "handled_by_setup": true,
    "priority": "low",
    "optional": true,
    "description": "Cinebench — native Apple Silicon CPU + GPU render benchmark; used by macOS/benchmarks/standardized.sh. Installed from Maxon's .dmg (the brew cask's pinned checksum goes stale against Maxon's rolling build)"
  },
  {
    "name": "blender-benchmark",
    "tags": ["benchmarking"],
    "package_manager": { "macos": "brew-cask" },
    "priority": "low",
    "optional": true,
    "description": "Blender Benchmark — Metal GPU render workload (samples/min); used by macOS/benchmarks/standardized.sh"
  },
  {
    "name": "omlx",
    "tags": ["local-llm"],
    "package_manager": { "macos": "custom" },
    "install_command": "bash \"$SETUP_ROOT/macOS/install-omlx-app.sh\"",
    "handled_by_setup": true,
    "priority": "low",
    "optional": true,
    "description": "oMLX menu-bar app — native macOS front end + MLX inference server (web chat at /admin/chat). Installed from the GitHub .dmg; do not also install the omlx brew formula (port/state conflict)"
  },
  {
    "name": "nmap",
    "tags": ["networking"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay", "server": "apt" },
    "priority": "low",
    "optional": true,
    "description": "Network scanner — discover hosts and open ports on the local network"
  },
  {
    "name": "samba",
    "tags": ["networking"],
    "package_manager": { "server": "apt" },
    "priority": "low",
    "optional": true,
    "description": "SMB/CIFS file sharing — exposes network shares to macOS and Windows; requires manual smb.conf configuration after install"
  },
  {
    "name": "gogcli",
    "tags": ["productivity"],
    "package_manager": { "macos": "brew" },
    "priority": "low",
    "optional": true,
    "description": "Google Workspace CLI — Gmail, Calendar, Drive, Docs, and more in the terminal"
  },
  {
    "name": "fluidtop",
    "tags": ["system-monitoring"],
    "package_manager": { "macos": "pipx" },
    "priority": "low",
    "optional": true,
    "description": "Apple Silicon performance monitor with AI workload focus — alternative to mactop"
  },
  {
    "name": "exifread",
    "tags": ["media", "photos"],
    "package_manager": { "macos": "pipx" },
    "priority": "low",
    "optional": true,
    "description": "Python CLI for reading EXIF metadata from JPEG and TIFF photos"
  },
  {
    "name": "Goodnotes",
    "tags": ["productivity"],
    "package_manager": { "macos": "app-store" },
    "priority": "low",
    "optional": true,
    "description": "Handwriting and note-taking app with Apple Pencil support"
  },
  {
    "name": "spotify",
    "tags": ["entertainment"],
    "package_manager": { "ubuntu": "snap", "arch": "yay" },
    "priority": "low",
    "optional": true,
    "environment": ["personal"],
    "description": "Music streaming"
  },
  {
    "name": "steam",
    "tags": ["entertainment"],
    "package_manager": { "ubuntu": "apt", "arch": "yay" },
    "priority": "low",
    "optional": true,
    "environment": ["personal"],
    "description": "Game library and storefront"
  },
  {
    "name": "bolt-launcher",
    "tags": ["entertainment"],
    "package_manager": { "arch": "yay" },
    "priority": "low",
    "optional": true,
    "environment": ["personal"],
    "description": "Open-source RuneScape/OSRS launcher for Linux — replaces Jagex Launcher"
  },
  {
    "name": "octave",
    "tags": ["science"],
    "package_manager": { "macos": "brew", "ubuntu": "apt", "arch": "yay" },
    "priority": "none",
    "optional": true,
    "environment": { "ubuntu": ["work"], "arch": ["work"] },
    "description": "MATLAB-compatible numerical computing environment"
  },
  {
    "name": "qemu",
    "tags": ["containers"],
    "package_manager": { "macos": "brew" },
    "priority": "none",
    "optional": true,
    "description": "Machine emulator — run x86, ARM, and other architectures on Apple Silicon"
  },
  {
    "name": "mongodb-community",
    "tags": ["database"],
    "package_manager": { "macos": "custom" },
    "priority": "none",
    "optional": true,
    "install_command": "brew tap mongodb/brew && brew install mongodb-community",
    "description": "MongoDB Community Server — includes mongosh and mongodb-database-tools"
  },
  {
    "name": "Pixelmator Pro",
    "tags": ["photos"],
    "package_manager": { "macos": "app-store" },
    "priority": "none",
    "optional": true,
    "description": "Photo editor — pay once"
  },
  {
    "name": "Amphetamine",
    "tags": ["desktop-utility"],
    "package_manager": { "macos": "app-store" },
    "priority": "none",
    "optional": true,
    "description": "Keep Mac awake with scheduling and app triggers — more powerful alternative to Caffeine"
  }
]