📦 Instalación — CLI omc

OhMyConfig incluye una CLI interactiva (omc) escrita en Bash 3.2+ nativo con interfaz TUI vía gum. Permite seleccionar exactamente qué módulos instalar, diagnosticar el entorno, actualizar herramientas y gestionar el agente de IA Pi sin depender previamente de ninguna shell externa.

---

1. Primera Instalación

git clone https://github.com/hcastillaq/OhMyConfig.git ~/Codigos/OhMyConfig
cd ~/Codigos/OhMyConfig
./omc install

El CLI te guía con dos pantallas interactivas:

Paso 1 — Modo de despliegue:

❯ Symlinks (recomendado — cambios en repo se reflejan al instante)
  Copia con respaldo

Navegá con ↑ ↓ y confirmá con Enter.

Paso 2 — Selección de módulos:

  Seleccioná módulos (x = marcar/desmarcar, a = todos, Enter = confirmar)

• Core         Fish · Starship · mise · Atuin · Nerd Fonts
• Terminal     Ghostty · Zellij
• Editor       Neovim · Git-Delta · Lazygit · gh · Bat · Glow
• Búsqueda     rg · fd · fzf · sd · yazi · zoxide · eza · dust
• CLI / TUI    btm · procs · xh · jq · jqp · tokei · onefetch
• DevOps       lazydocker · k9s · kubectx/kubens
• AI / Pi      pi (Coding Agent en terminal)

Tecla	Acción
↑ / ↓	Mover cursor
x	Marcar / desmarcar módulo
a	Seleccionar / deseleccionar todos
Enter	Confirmar selección e instalar
q / Esc	Cancelar

---

2. Referencia Completa de Comandos

omc install — Instalador Interactivo

./omc install                  # Menú TUI para elegir modo y módulos
./omc install --all            # Instala todos los módulos en modo copia
./omc install --all --link     # Instala todos los módulos en modo symlink
./omc install --link           # Menú de módulos pero fuerza modo symlink

---

omc doctor — Diagnóstico del Entorno

Muestra el estado de cada herramienta instalada, su versión y qué módulos faltan. Funciona en máquinas nuevas sin necesitar perfil previo.

./omc doctor

Salida de ejemplo:

⚡ OhMyConfig — Estado del Entorno
────────────────────────────────────────────────────────
  Core
  ✅  fish                   4.0.2
  ✅  starship               1.26.0
  ✅  mise                   2024.12.0
  ✅  atuin                  18.4.0

  Editor
  ✅  nvim                   0.12.5
  ✅  delta                  0.19.2
  ✅  lazygit                0.44.1

  AI / Pi
  ✅  pi                     0.84.4

  Infraestructura
  ✅  brew                   4.4.17
  ✅  gum                    2.0.0
  ✅  node                   22.14.0 (via mise)

  Perfil: modo=symlink  módulos=[core terminal editor search cli devops ai]
  ✅ 31 instaladas · 0 faltantes
────────────────────────────────────────────────────────

---

omc update — Actualización Completa

Actualiza Homebrew, todas las fórmulas/casks instalados y el agente pi (npm global) de una sola vez.

./omc update

⚡ OhMyConfig — Actualizando entorno
  ⠋ Actualizando repositorio de Homebrew...   ✅ Hecho
  ⠋ Actualizando fórmulas instaladas...       ✅ 4 paquetes actualizados
  ⠋ Actualizando casks instalados...          ✅ Hecho

  AI / Pi (npm globals)
  ✅  pi              0.84.4  (latest)

  🧹 Caché limpiado
  ✅ Actualización completada.

---

omc dev — Gestión del Agente Pi & Suite LazyPi

Instala el agente base pi y el catálogo oficial completo de LazyPi (lazypi.org) con 17 extensiones curadas para desarrollo autónomo, subagentes, diagnósticos LSP y memoria offline.

./omc dev              # Instala pi y todo el catálogo de LazyPi (Core + Optional)
./omc dev status       # Diagnóstico de salud y estado de las 17 extensiones
./omc dev update       # Actualiza el binario de pi y todas las extensiones
./omc dev doctor       # Chequeo de salud del entorno (Node, git, auth, settings)
./omc dev remove       # Selector interactivo para desinstalar extensiones

---

omc --help — Ayuda General

./omc --help
./omc -h

---

3. Modos de Despliegue

Symlinks (Recomendado para desarrollo activo de dotfiles)

Crea enlaces simbólicos de ~/.config/ directamente a los archivos del repositorio. Cualquier edición en el repo se refleja de inmediato sin reinstalar.

./omc install --all --link

Copia con Respaldo

Copia los archivos a ~/.config/. Si existe un archivo modificado, genera un respaldo automático con timestamp (.bak_YYYYMMDD_HHMMSS) antes de sobrescribir. Recomendado para producción o máquinas compartidas.

./omc install --all

---

4. Módulos Disponibles

Módulo	Herramientas	Configs desplegadas
core	Fish · Starship · mise · Atuin · Nerd Fonts	fish/config.fish, fish/functions/, starship.toml, atuin/config.toml
terminal	Ghostty · Zellij	ghostty/config, zellij/config.kdl, layouts, plugins
editor	Neovim · Git-Delta · Lazygit · gh · Bat · Glow	nvim/, lazygit/config.yml, git/delta.gitconfig
search	rg · fd · fzf · sd · yazi · zoxide · eza · dust	— (integradas en Fish)
cli	btm · procs · xh · jq · jqp · tokei · onefetch	bottom/bottom.toml
devops	lazydocker · k9s · kubectx/kubens	—
ai	pi (Coding Agent en terminal)	— (npm global)

---

5. Perfil de Instalación (.omc-profile)

Al finalizar, omc install guarda un perfil local:

# .omc-profile — generado por omc install
deploy_mode=symlink
modules=core terminal editor search cli devops ai

omc update y omc doctor lo leen para saber qué módulos tenés activos. Podés commitearlo para replicar el setup exacto en otra máquina.

---

6. Pasos Posteriores Recomendados

1. Establecer Fish como shell por defecto en macOS:

   echo "$(which fish)" | sudo tee -a /etc/shells
   chsh -s "$(which fish)"

2. Instalar tus runtimes con mise:

   mise use -g node@lts
   mise use -g python@latest
   mise use -g go@latest

3. Abrir Ghostty para disfrutar del renderizado GPU y el tema Tokyonight completo.
4. Instalar pi y la suite oficial LazyPi (Core + Optional):

   ./omc dev