Herramientas por rol — Instalación estándar Wiedii

Principio fundamental

Todo programa que se instala en una máquina de Wiedii se instala con Homebrew.

Esto incluye editores de código, navegadores, clientes de comunicación, VPNs y cualquier aplicación de escritorio. Nunca se descarga un instalador .dmg o .pkg directamente de una página web. Nunca se arrastra manualmente una app a /Applications.

Excepción: si un programa genuinamente no está disponible en Homebrew (ni como formula ni como cask), puede instalarse por el método oficial del proveedor — únicamente con autorización explícita del TL antes de proceder. La excepción debe quedar documentada en el vault. Ver gestion-herramientas-brew-mise para el proceso.

# ✅ Correcto — siempre
brew install google-chrome
brew install visual-studio-code
brew install microsoft-teams
brew install nordvpn

# ❌ Nunca en Wiedii
# Ir a chrome.com → descargar .dmg → arrastrar a Applications
# Ir a code.visualstudio.com → descargar .zip → abrir
# Ir a teams.microsoft.com → descargar .pkg → instalar

Por qué importa: brew mantiene un inventario auditado de lo que está instalado, permite actualizar todo con brew upgrade, y garantiza que cualquier dev pueda replicar el entorno exacto corriendo los mismos comandos. Los instaladores manuales quedan fuera de control.

Ver gestion-herramientas-brew-mise para la filosofía completa.

⛔ Podman / Podman Desktop / Docker Desktop — NO autorizados. El runtime de contenedores es OrbStack (brew install orbstack).

Nivel 0 — Fundación (todos los devs, sin excepción)

Instalar primero. Todo lo demás depende de esto.

# 1. Homebrew (único curl | bash permitido en Wiedii)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Apple Silicon — activar en el shell actual
eval "$(/opt/homebrew/bin/brew shellenv)"

# 2. Gestión de versiones por proyecto
brew install mise

# 3. Git + flujo de trabajo Wiedii
brew install git git-flow-next

# 4. GitLab CLI — crear MRs, ver pipelines, desde terminal
brew install glab

Continuar con configuracion-zsh antes de instalar más herramientas.

Nivel 1 — Terminal y shell (todos los devs)

Herramientas Rust 🦀 — reemplazos modernos de Unix/GNU

brew install bat eza fd ripgrep sd starship gping tlrc

Herramienta	Reemplaza	Ventaja
`bat`	`cat`	Syntax highlighting, git diff
`eza`	`ls`	Iconos, columna git status
`fd`	`find`	Respeta `.gitignore`, ergonómico
`ripgrep`	`grep`	El más rápido, paralelismo automático
`sd`	`sed`	Regex estándar, cross-platform
`starship`	prompt zsh	Contextual (rama, runtime, kubectl…)
`gping`	`ping`	Gráfica de latencia en tiempo real
`tlrc`	`man`	Resúmenes con ejemplos prácticos

Ver herramientas-rust para uso detallado, alias y por qué Rust.

Resto de herramientas de terminal

brew install \
  jq \
  yq \
  tree \
  htop \
  wget \
  rsync \
  git-crypt \
  git-filter-repo \
  gnupg \
  yamllint \
  gnu-getopt \
  mas

Herramienta	Para qué
`jq`	Procesar y filtrar JSON en terminal
`yq`	Procesar YAML, JSON y TOML
`tree`	Visualizar estructura de directorios
`htop`	Monitor de procesos interactivo
`rsync`	Sincronización eficiente de archivos y backups
`git-crypt`	Cifrar archivos sensibles en repos git
`git-filter-repo`	Reescribir historia de git (limpiar secrets, renombrar)
`gnupg`	Gestión de claves GPG (firmar commits, cifrar archivos)
`yamllint`	Validar sintaxis de archivos YAML
`mas`	Instalar apps del Mac App Store desde terminal

Terminal y fuentes

brew install \
  warp \
  font-jetbrains-mono-nerd-font \
  font-hack-nerd-font \
  font-jetbrains-mono

Nivel 2 — Contenedores y virtualización (todos los devs)

brew install orbstack

# VMs adicionales (si se necesitan Linux nativos o pruebas de SO)
brew install utm

Herramienta	Para qué	No usar
`orbstack`	Runtime Docker + Kubernetes + VMs Linux ligero	Docker Desktop, Podman
`utm`	VMs macOS/Linux/Windows (Apple Virtualization Framework)	VirtualBox en Apple Silicon

virtualbox no es compatible con Apple Silicon de forma nativa. Usar orbstack para contenedores y utm para VMs completas.

Nivel 3 — Navegadores (todos los devs)

⚠️ Ningún navegador se instala descargando un .dmg. Todos van por brew install.

# Navegadores de uso general
brew install brave-browser
brew install google-chrome
brew install firefox

# Desarrollo web
brew install firefox@developer-edition

# Privacidad y pruebas
brew install mullvad-browser
brew install microsoft-edge
brew install opera

Herramienta	Uso recomendado
`brave-browser`	Navegación diaria — bloqueador de ads nativo
`google-chrome`	Pruebas de compatibilidad y DevTools Chrome
`firefox`	Navegación / pruebas cross-browser
`firefox@developer-edition`	Desarrollo web — DevTools avanzados, CSS Grid inspector
`mullvad-browser`	Navegación privada, pruebas sin huellas
`microsoft-edge`	Pruebas en Chromium alternativo, integraciones M365

Nivel 4 — Editores y IDEs (todos los devs)

⚠️ Ningún editor se instala descargando un .zip o .dmg de la web. Todos van por brew install.

# Editor principal — VS Code (estándar Wiedii)
brew install visual-studio-code

# Alternativas de editor
brew install zed             # escrito en Rust, ultrarrápido

# Suite JetBrains (backend / mobile)
brew install jetbrains-toolbox   # instala y actualiza todos los IDEs de JetBrains

# Editor ligero
brew install sublime-text

Herramienta	Lenguaje base	Perfil
`visual-studio-code`	TypeScript	Editor estándar Wiedii — mayor ecosistema de extensiones, configuración compartida vía Settings Sync
`zed`	Rust	El más rápido disponible, colaboración en tiempo real
`jetbrains-toolbox`	Java/Kotlin	IntelliJ, WebStorm, GoLand, DataGrip — gestiona updates
`sublime-text`	C++	Editor ligero para archivos sueltos y config

zed es el único editor de esta lista escrito en Rust — misma filosofía que bat, eza, fd. Ver herramientas-rust. IA en el editor: el asistente oficial de Wiedii es Claude Code (claude-code) y Cowork (claude). Editores AI-first como Cursor y OpenCode no están autorizados. Ver politicas-core.

Nivel 5 — Comunicación (todos los devs)

brew install \
  microsoft-teams \
  telegram \
  whatsapp \
  beeper \
  proton-mail \
  thunderbird

Herramienta	Para qué
`microsoft-teams`	Canal principal de comunicación e ingeniería Wiedii
`telegram`	Comunicación de equipo informal
`whatsapp`	Comunicación rápida
`beeper`	Cliente unificado de mensajería (todos los chats en uno)
`proton-mail`	Correo con cifrado extremo a extremo
`thunderbird`	Cliente de correo local con soporte IMAP/SMTP

Nivel 6 — Backend

brew install postgresql@16 mariadb

brew install \
  dbeaver-community \
  studio-3t-community \
  mongodb-compass \
  insomnia \
  yaak \
  postman

Herramienta	Para qué
`postgresql@16`	Base de datos local PostgreSQL
`mariadb`	Base de datos local MySQL-compatible
`dbeaver-community`	GUI universal para bases de datos relacionales
`studio-3t-community`	GUI completa para MongoDB (recomendada)
`mongodb-compass`	GUI oficial MongoDB (más ligera)
`insomnia`	Cliente REST/GraphQL con gestión de colecciones
`yaak`	Cliente API moderno, alternativa ligera a Postman
`postman`	Cliente API con workspaces colaborativos

Nivel 7 — DevOps / Infra

brew install \
  kubernetes-cli \
  dive \
  popeye \
  cosign \
  infracost \
  awscli \
  mole \
  docker-credential-helper-ecr

brew install \
  lens \
  headlamp

Herramienta	Para qué
`kubernetes-cli`	`kubectl` — interactuar con clusters Kubernetes
`lens`	IDE gráfico para Kubernetes — gestión visual de recursos
`headlamp`	UI web para Kubernetes, alternativa open-source a Lens
`dive`	Inspeccionar capas de imágenes Docker (detectar bloat)
`popeye`	Auditar recursos y configuraciones de un cluster
`cosign`	Firmar y verificar imágenes de contenedor
`infracost`	Estimar costo de cambios de infraestructura Terraform
`awscli`	Interactuar con AWS desde terminal
`mole`	Gestionar túneles SSH de forma declarativa
`docker-credential-helper-ecr`	Autenticación automática con Amazon ECR

Nivel 8 — Seguridad y red

brew install \
  nordvpn \
  tunnelblick \
  tailscale-app \
  cyberduck

Herramienta	Para qué
`nordvpn`	VPN corporativa — acceso a recursos internos
`tunnelblick`	VPN con configuraciones OpenVPN personalizadas
`tailscale-app`	Red mesh segura — conectar servicios sin abrir puertos
`cyberduck`	Cliente FTP/SFTP/S3/WebDAV con GUI

Nivel 9 — Productividad y diseño

brew install \
  obsidian \
  claude \
  claude-code \
  notion \
  drawio \
  figma \
  alfred \
  cleanmymac \
  microsoft-office \
  languagetool-desktop \
  adobe-acrobat-reader \
  owncloud \
  capcut

Herramienta	Para qué
`obsidian`	Vault de documentación interna (este repositorio)
`claude`	Asistente IA — Cowork mode para tareas de documentación
`claude-code`	Asistente IA en terminal para tareas de código
`notion`	Gestión de proyectos y documentos de equipo
`drawio`	Diagramas de arquitectura, flujos y ERDs
`figma`	Diseño de interfaces y prototipos
`alfred`	Launcher, automatizaciones y snippets rápidos
`cleanmymac`	Mantenimiento y limpieza del sistema macOS
`microsoft-office`	Suite ofimática corporativa
`languagetool-desktop`	Corrección gramatical multilenguaje
`adobe-acrobat-reader`	Lectura y anotación de PDFs
`owncloud`	Almacenamiento y sincronización de archivos corporativos
`capcut`	Edición de video para contenido de equipo

Instalación por perfil — un solo bloque

Nuevo dev backend

# Nivel 0 + Nivel 1
brew install \
  mise git git-flow-next glab \
  bat eza fd ripgrep sd starship gping tlrc \
  jq yq tree htop wget rsync git-crypt git-filter-repo gnupg yamllint gnu-getopt mas

# Terminal + contenedores
brew install orbstack warp font-jetbrains-mono-nerd-font

# Nivel 3 + 4 + 5
brew install \
  brave-browser firefox@developer-edition \
  visual-studio-code \
  microsoft-teams

# Nivel 6
brew install postgresql@16 mariadb
brew install dbeaver-community insomnia

Nuevo dev DevOps / Infra

# Nivel 0 + Nivel 1
brew install \
  mise git git-flow-next glab \
  bat eza fd ripgrep sd starship gping tlrc \
  jq yq tree htop wget rsync git-crypt git-filter-repo gnupg yamllint gnu-getopt mas

# Terminal + contenedores
brew install orbstack warp font-jetbrains-mono-nerd-font

# Nivel 3 + 4 + 5
brew install \
  brave-browser firefox@developer-edition \
  visual-studio-code \
  microsoft-teams

# Nivel 7
brew install kubernetes-cli dive popeye cosign infracost awscli mole docker-credential-helper-ecr
brew install lens

⛔ Prohibido en Wiedii

Acción	Por qué	Alternativa
Descargar `.dmg` / `.pkg` / `.zip` de webs sin autorización	Fuera de control de brew, no reproducible	`brew install <app>` — si no existe en brew, pedir autorización al TL
`podman` / `podman-desktop`	No autorizado	OrbStack
Docker Desktop	Licencia comercial	OrbStack
`npm install -g <herramienta>`	Contamina entorno global	mise o brew
`pip install --user <herramienta>`	Dependencias no reproducibles	brew o mise
`curl \| bash` (genérico)	Inseguro, no reproducible	brew — única excepción es el bootstrap inicial de Homebrew
Binarios descargados a mano sin autorización	Sin control de versiones ni verificación	brew — si no existe en brew, solicitar autorización al TL
Cursor (editor AI-first)	No autorizado — el asistente IA oficial es Claude Code	`claude-code` + `claude` (Cowork)
OpenCode (CLI IA)	No autorizado	`claude-code`

Referencias

herramientas-rust — guía detallada de cada herramienta Rust: uso, alias, ejemplos
gestion-herramientas-brew-mise — filosofía Homebrew + mise
configuracion-zsh — setup del shell tras instalar estas herramientas
guia-nuevo-dev — tutorial completo de onboarding
orbstack — runtime de contenedores
glab — GitLab CLI

Principio fundamental​

Nivel 0 — Fundación (todos los devs, sin excepción)​

Nivel 1 — Terminal y shell (todos los devs)​

Herramientas Rust 🦀 — reemplazos modernos de Unix/GNU​

Resto de herramientas de terminal​

Terminal y fuentes​

Nivel 2 — Contenedores y virtualización (todos los devs)​

Nivel 3 — Navegadores (todos los devs)​

Nivel 4 — Editores y IDEs (todos los devs)​

Nivel 5 — Comunicación (todos los devs)​

Nivel 6 — Backend​

Nivel 7 — DevOps / Infra​

Nivel 8 — Seguridad y red​

Nivel 9 — Productividad y diseño​

Instalación por perfil — un solo bloque​

Nuevo dev backend​

Nuevo dev DevOps / Infra​

⛔ Prohibido en Wiedii​

Referencias​