https://github.com/jesuserro/dotfiles
Dotfiles architected for MCP, Multi-Agent workflows (Cursor/Claude/Codex) & Data Engineering. Managed with chezmoi + sops + age. Turning my local environment into a portable AI-Augmented Workstation 🤖.
https://github.com/jesuserro/dotfiles
ai ai-agents chezmoi claude codex cursor dotfiles dotfiles-linux mcp mcp-client mcp-server oh-my-zsh skills sops zsh
Last synced: about 1 month ago
JSON representation
Dotfiles architected for MCP, Multi-Agent workflows (Cursor/Claude/Codex) & Data Engineering. Managed with chezmoi + sops + age. Turning my local environment into a portable AI-Augmented Workstation 🤖.
- Host: GitHub
- URL: https://github.com/jesuserro/dotfiles
- Owner: jesuserro
- Created: 2020-12-20T08:11:17.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2026-05-23T21:56:02.000Z (about 1 month ago)
- Last Synced: 2026-05-23T22:10:48.307Z (about 1 month ago)
- Topics: ai, ai-agents, chezmoi, claude, codex, cursor, dotfiles, dotfiles-linux, mcp, mcp-client, mcp-server, oh-my-zsh, skills, sops, zsh
- Language: Shell
- Homepage:
- Size: 14.5 MB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Dotfiles
> **Aviso:** Proyecto personal. Requiere experiencia con Linux/WSL: `chezmoi apply` puede sobrescribir configuración en HOME.
Capa de configuración de usuario para **Ubuntu LTS / WSL2** (Windows 11 Pro): shell, MCPs para agentes IA, secretos cifrados y mantenimiento del sistema.
> **Legacy:** RCM (`rcup`, `.rcrc`) fue el gestor histórico de symlinks. **No es operativo.** El flujo canónico es **Chezmoi** + **SOPS/age**.
---
## Arquitectura en tres capas
| Capa | Herramientas | Rol |
|------|--------------|-----|
| **Bootstrap** | `make install*`, `make deps-*` | APT, diagnóstico, opt-in (`install-chezmoi`, `install-sops`, `install-zsh-stack`) |
| **Materialización** | `chezmoi status` / `diff` / `apply` | Symlinks RC, MCPs, `~/.config/mcp-secrets.env` generado, runtime AI |
| **Mantenimiento** | `make update`, `make ai-cursor-check`, `make ai-mcp-governance` | Sistema y herramientas — **no** sustituye `chezmoi apply` |
```mermaid
flowchart LR
bootstrap["make install*"] --> chezmoi["chezmoi apply"]
chezmoi --> home["HOME ~/.cursor, ~/.zshrc, mcp-secrets.env"]
update["make update"] --> tools["APT, npm, MCP images"]
```
---
## Qué comando usar cuándo
| Situación | Comando |
|-----------|---------|
| Máquina nueva, instalar paquetes base | `make install-check` → `make install` (ver [INSTALL.md](docs/INSTALL.md)) |
| Publicar plantillas y secretos a HOME | `chezmoi --source=$HOME/dotfiles apply` o `make install-dotfiles DOTFILES_APPLY=1` |
| Solo recargar aliases/PATH en la sesión | `source ~/.zshrc` |
| Editar token GitHub, DSN Postgres, MinIO | `sops secrets.sops.yaml` → `chezmoi apply -i scripts` |
| Actualizar Windows/WSL, APT, npm, OMZ, MCPs | `make update` |
| Validar Cursor/MCP/skills en HOME | `make ai-cursor-check` |
| Validar MANIFEST ↔ plantillas en repo | `make ai-mcp-governance` |
| Regenerar plantillas MCP desde MANIFEST | `make ai-mcp-generate APPLY=1` → `chezmoi apply` |
`make install` **no** ejecuta `chezmoi apply` por defecto. Son pasos distintos.
---
## Máquina nueva (resumen)
```bash
git clone https://github.com/jesuserro/dotfiles.git ~/dotfiles && cd ~/dotfiles
make install-check && make install SKIP_EXTERNAL=1
make install-chezmoi && make install-sops && make install-zsh-stack
# Restaurar ~/.config/sops/age/keys.txt (manual)
sops secrets.sops.yaml
make install-dotfiles DOTFILES_APPLY=1
source ~/.zshrc
```
Detalle: [docs/INSTALL.md](docs/INSTALL.md) · operación diaria: [docs/OPERATIONS.md](docs/OPERATIONS.md).
---
## Máquina existente (resumen)
```bash
cd ~/dotfiles && git pull
chezmoi --source="$HOME/dotfiles" status
chezmoi --source="$HOME/dotfiles" apply
source ~/.zshrc
# opcional: make update
```
---
## Documentación
| Doc | Contenido |
|-----|-----------|
| **[docs/OPERATIONS.md](docs/OPERATIONS.md)** | Guía operativa principal (flujos, secretos, MCPs, riesgos, chuleta) |
| [docs/INSTALL.md](docs/INSTALL.md) | Bootstrap e instalación inicial |
| [docs/CHEZMOI.md](docs/CHEZMOI.md) | Chezmoi, SOPS, symlinks RC, scripts, `ZSH_RC_APPLY` |
| [docs/SECRETS_EXAMPLES.md](docs/SECRETS_EXAMPLES.md) | Ejemplos de secretos (GitHub, Postgres, MinIO) |
| [docs/UPDATE.md](docs/UPDATE.md) | `make update` (mantenimiento; no aplica Chezmoi) |
| [docs/GUIA_MCP_AI.md](docs/GUIA_MCP_AI.md) | MCPs, skills, comandos AI |
| [docs/MCP_QUICKREF.md](docs/MCP_QUICKREF.md) | Referencia rápida para agentes |
| [docs/README.md](docs/README.md) | Índice completo |
## Estructura y testing
```
dotfiles/
├── ai/ # MCPs, skills, MANIFEST
├── dot_cursor/ # Plantillas MCP Cursor
├── docs/ # Documentación humana
├── secrets.sops.yaml # Secretos cifrados (SOPS)
└── zshrc, aliases/ # RC gestionados por symlinks Chezmoi
```
```bash
make test-fast
```
Ver [docs/TESTING.md](docs/TESTING.md) · árbol: [STRUCTURE.md](STRUCTURE.md).
## License
MIT