# Family / machine shared config (Ilia + Irina)

Shell, Cursor rules/skills, and install helpers so either Mac can:

```bash
git clone gitea@git.levkin.ca:ilia/dotfiles.git ~/Documents/code/dotfiles
cd ~/Documents/code/dotfiles
./install.sh          # Ilia / general
./install.sh --ira    # Irina — same install + printed follow-ups
exec zsh
```

## What’s in here

| Path | Purpose |
|------|---------|
| `.zshrc` | Live Oh My Zsh + Powerlevel10k config (portable `$HOME` paths) |
| `.p10k.zsh` | Prompt theme |
| `zsh/homelab.zsh` | Ansible shortcuts (`hsp`, `hs`, `mk`, `hvk`, `mps`, …) |
| `zsh/zshrc.local.example` | → `~/.zshrc.local` for machine-only tweaks |
| `cursor/rules/` | Shared Cursor rules (`family-machine`, `new-project-standards`) |
| `cursor/skills/` | Shared skills (`humanizer`, `frontend-design`, `ui-ux-pro-max`) |
| `cursor/mcp.json.example` | Optional Playwright MCP (no Hermes SSH) |
| `scripts/git-hooks/` | Local gitleaks pre-commit |

### Cursor skills — which one?

- **frontend-design** — distinctive, anti-template UI for one-off products (default for personal apps).
- **ui-ux-pro-max** — searchable style/palette/UX database + design-system generator (SaaS/landing/dashboard checklists). Upstream: [nextlevelbuilder/ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill). See `cursor/skills/ui-ux-pro-max/ORIGIN.md`.
- **humanizer** — de-AI writing tone.

**Not** included (stay on Ilia’s machine only): job-application Cursor rules,
Hermes MCP over SSH, Ansible Vault password, full `~/.cursor` dump.

## Irina — pull and go

```bash
git clone gitea@git.levkin.ca:ilia/dotfiles.git ~/Documents/code/dotfiles
cd ~/Documents/code/dotfiles && ./install.sh --ira
```

Then follow the printed steps: Vaultwarden app password → clone
`personal-scripts` → `.env.irina` → Cursor prompt.

Gmail work lives in **`ilia/personal-scripts`** (lighter than full ansible).
Ansible is optional unless you want `hsp` / inventory SSH helpers.

## Ilia — keep this repo updated

When `~/.zshrc` drifts:

1. Edit files **in this repo** (or sync from live after reviewing diffs).
2. `./install.sh` re-links.
3. Commit + push `master` so Irina can `git pull` and re-run `./install.sh`.

Homelab Make/SSH helpers expect `~/Documents/code/ansible`. Gmail Make
targets for Irina expect `~/Documents/code/personal-scripts`.

## Prerequisites (macOS)

- Oh My Zsh + Powerlevel10k theme
- Recommended: `brew install fzf jq direnv` (and `fzf` for `hsp`)
- Optional OMZ plugins: `zsh-autosuggestions`, `zsh-syntax-highlighting`,
  `zsh-history-substring-search` under `$ZSH_CUSTOM/plugins/`

## Safety

- `install.sh` backs up existing `~/.zshrc` / `~/.p10k.zsh` before replacing.
- Does not overwrite an existing `~/.cursor/mcp.json`.
- No secrets in this repo — use Vaultwarden and gitignored `.env*` files.