Dotfiles

Personal dotfiles para Ubuntu 20.04+, Zsh, Oh My Zsh, TMUX y Neovim. Incluye AI Workstation (MCPs, skills, secretos) gestionado con Chezmoi.

Aviso: Este es un proyecto personal. No experimentes con estos dotfiles si no tienes un mínimo de experiencia con Linux y la terminal: podrías sobrescribir o romper configuraciones en tu sistema.

---

Arquitectura

flowchart TB
    subgraph repo [dotfiles repo]
        direction LR
        ai["AI<br/>(MCPs + Skills)"] --- cursor[dot_cursor/] --- codex[dot_codex/] --- secrets[secrets.sops.yaml]
    end

    subgraph home [HOME ~/]
        direction LR
        config_ai[.config/ai/] --- dot_cursor[.cursor/] --- dot_codex[.codex/] --- dot_secrets[.secrets/]
    end

    repo -->|chezmoi apply| home

Loading

Sistema	Gestiona	Doc
Chezmoi + SOPS + Age	MCPs, secretos, AI Workstation	CHEZMOI.md
RCM (rcup)	zsh, tmux, vim, aliases	RCM

---

Cuándo usar qué: rcup, source y chezmoi

En este proyecto conviven tres formas de aplicar cambios. Usa cada una en su momento:

Acción	Cuándo usarla
rcup -v	Cuando cambias archivos del repo que RCM gestiona (zsh, tmux, vim, aliases). Crea o actualiza symlinks en tu $HOME.
source ~/.zshrc	Después de rcup o de ups: recarga en la sesión actual los aliases, funciones y el PATH. No modifica archivos en disco.
chezmoi --source=$HOME/dotfiles apply	Cuando cambias en el repo lo que Chezmoi gestiona (MCPs, plantillas en dot_cursor/, dot_codex/, secretos, runtime AI). Lleva esos cambios a ~/.cursor/, ~/.codex/, etc.

Ejemplo: Si solo ejecutas ups (actualizar sistema y MCPs), no hace falta chezmoi; basta source ~/.zshrc para que la shell use la configuración actual. Chezmoi solo es necesario cuando tú editas plantillas o archivos del repo (por ejemplo añades un MCP en dot_cursor/mcp.json.tmpl).

Detalle: docs/CHEZMOI.md#cuándo-usar-rcup-source-y-chezmoi.

---

Install

git clone https://github.com/jesuserro/dotfiles.git ~/dotfiles
cd ~/dotfiles
chezmoi --source=$HOME/dotfiles apply
rcup -v && source ~/.zshrc

Guía completa: docs/INSTALL.md — requisitos, Age, SOPS, secretos.

---

Guías rápidas

Tarea	Doc
Actualizar sistema (APT, MCPs, Oh My Zsh)	UPS.md
Añadir un MCP servidor	GUIA_MCP_AI.md
Añadir un skill	GUIA_MCP_AI.md
Añadir un secreto (Postgres, MinIO)	SECRETS_EXAMPLES.md
Cambiar token GitHub	CAMBIAR_TOKEN_GITHUB.md
Aplicar cambios	chezmoi --source=$HOME/dotfiles apply

---

Update

cd ~/dotfiles
git pull
chezmoi --source=$HOME/dotfiles apply
rcup -v
source ~/.zshrc

Actualización integral del sistema: ups — APT, npm, Oh My Zsh, MCPs. Ver docs/UPS.md.

---

Documentación

Doc	Contenido
docs/README.md	Índice completo
docs/MCP_TAXONOMY.md	Taxonomía de MCPs (clasificación y políticas)
docs/UPS.md	Comando ups — actualización del sistema
docs/INSTALL.md	Instalación paso a paso
docs/GUIA_MCP_AI.md	MCPs, skills, comandos
docs/CHEZMOI.md	Chezmoi + SOPS + Age
docs/GIT_WORKFLOW.md	Git (feat, rel, changelog)
ai/README.md	AI Workstation Framework

---

Estructura del repo

dotfiles/
├── ai/                 # AI Workstation (MCPs, skills)
├── dot_cursor/         # Templates MCP Cursor
├── dot_codex/          # Templates Codex
├── docs/               # Documentación
├── zsh, tmux, vim/     # Shell, terminal, editor
└── secrets.sops.yaml   # Secretos cifrados

---

Customizations

~/dotfiles-local/*.local — aliases, gitconfig, tmux, vimrc, zshrc. Ver RCM.

---

Testing

make test           # All tests
make test-install   # Install dependencies

See docs/TESTING.md for details.

---

Resources

Recurso	Enlace
Chezmoi	chezmoi.io
SOPS	github.com/getsops/sops
Age	github.com/FiloSottile/age
RCM	thoughtbot.github.io/rcm

---

License

MIT