dotfiles/README.md
ilia 78f7874055
All checks were successful
CI / skip-ci-check (pull_request) Successful in 19s
CI / secret-scan (pull_request) Successful in 17s
Sync live zsh + Cursor pack for family Macs
Bring .zshrc up to the current machine config (portable paths), ship
homelab/ansible shell helpers, shared Cursor rules/skills, and an
install.sh so Irina can clone and run ./install.sh --ira.
2026-07-26 16:00:43 -04:00

65 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
```
## Whats 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`) |
| `cursor/mcp.json.example` | Optional Playwright MCP (no Hermes SSH) |
| `scripts/git-hooks/` | Local gitleaks pre-commit |
**Not** included (stay on Ilias 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.