dotfiles

Imported from mflkee/dotfiles (AGENTS.md). Install upstream with npx skills add mflkee/dotfiles. Copyright stays with the author.

Dotfiles Rules

• This repository is the source of truth for files managed by chezmoi.
• Never edit live files under ~/.config, ~/.tmux.conf, ~/.zshrc, or similar paths directly when a matching source file exists here.
• Prefer editing files in this repo directly, or use chezmoi edit <target> --apply.
• The chezmoi source repo is /home/mflkee/dotfiles (chezmoi source-path).

Infrastructure

Centralized Obsidian on archlinux-server

• Server: archlinux-server (Netbird IP: 100.89.126.211)
• Vault: ~/obs_main — synced across machines via Syncthing (folder nzf3f-a9q4c, sendreceive), NOT git push
• REST API: http://100.89.59.195:27123 (via archlinux-mkair) and https://100.89.59.195:27124
• MCP Endpoints: /second-brain-mcp/ (obsidian-second-brain)
• API Key: Stored in OBSIDIAN_API_KEY env var

How to edit the vault

# On any machine — just edit; Syncthing propagates to all machines automatically.
# Optionally snapshot locally for versioning (NOT pushed anywhere):
cd ~/obs_main && git add -A && git commit -m "description"

dsync v2 (Rust, replaces old Python v1)

• Hub: archlinux-server:42069 (QUIC), systemd user unit dsync-hub.service, loginctl enable-linger mflkee enabled. Data: ~/.local/share/dsync-hub/machines.json
• Clients: ~/.local/bin/dsync, config ~/.config/dsync/dsync/config.toml (chezmoi template), 15-min dsync.timer on desktop/mkair/notebook
• Flow: client pushes zen + projects → hub stores → hub SSH-pulls projects on all other machines (git pull --rebase --autostash — незакоммиченная работа не теряется) + runs post_pull (dotfiles: chezmoi apply)
• Machine names: desktop, notebook, archlinux-mkair, archlinux-server. Hostname mapping: archlinux-desktop→desktop, archlinux-notebook→notebook, archlinux-mkair→archlinux-mkair, archlinux-server→archlinux-server. Notebook SSH-pull by IP 100.89.198.212
• Source: ~/projects/dsync; build: cargo build --release, deploy binary to ~/.local/bin/dsync (client) / dsync-hub (server)
• Note: binary is a single ~18MB ELF with rustls (no cert verification)
• Секреты: per-machine токен хаба — sidecar ~/.config/dsync/dsync/tokens.toml (0600, chezmoi-ignored, в git не попадает). Новой машине его надо завести вручную ([hub_connect] token = "…" из [hub] tokens на сервере), иначе хаб отвергнет запросы и машина будет «offline».

Dotfiles: no chezmoi edit needed (auto-capture)

• Любую правку живого файла (~/.zshrc, ~/.config/...) или исходника в ~/dotfiles можно делать напрямую (nvim, bash, sed) — dsync сам забирает её в репозиторий при каждом dsync push (сравнение sha256 по ~/.local/share/dsync/capture-state.json, погнал chezmoi re-add; правки исходников применяются локально через chezmoi apply --force).
• nvim-хук ~/.config/nvim/lua/custom/plugins/dsync-capture.lua делает это мгновенно на каждое :w (вызов dsync capture <path>). Отключить: let g:dsync_capture_enabled = v:false.
• Не захватываются: файлы с исходником .tmpl (правь шаблон), сгенерированные темы/.desktop, ~/Pictures, вложенные git-репо и не-managed файлы.

Синхронизация состояния: tmux + сессии opencode

• Управляется секцией [state] в конфиге (chezmoi-шаблон) и работает автоматически в dsync push/pull/watch — через хаб (сообщения state_push/state_pull, хранилище ~/.local/share/dsync-hub/state/).
• tmux: синхронизируется последний снапшот tmux-resurrect (~/.local/share/tmux/resurrect/); на приёмнике файл раскладывается, восстановить в живой tmux — prefix + Ctrl-r (или tmux_restore = true).
• opencode: синхронизируются сессии по всем [projects.*] (можно сузить: [state.opencode] projects = ["~/projects/…"]). На машине-источнике — session list --format json → session export изменившихся; на других — session import. Экспорт идёт с --standalone (в V2 экспорт через общий сервис недетерминированно обрезается — баг CLI).
• Локальный индекс ~/.local/share/dsync/state.json; сбойные элементы не теряются (seq откатывается), только что импортированное не пере-отправляется.
• opencode нужен V2 (@opencode/cli → ~/.opencode/bin/opencode), иначе сессии не синкаются (tmux при этом работает).

How to access Obsidian from any machine

• obsidian-memory MCP — reads vault files locally (via Syncthing)
• obsidian-second-brain MCP — points to archlinux-mkair:27123 (running Obsidian with plugins)

UPS / ИБП на mkair-server-tmn (NUT)

• Сервер: mkair-server-tmn (Netbird IP: 100.89.18.223)
• ИБП: APC Smart-UPS 1500 (FW 653.19.I), подключён по USB (vendor 051d, product 0002)
• ПО: NUT 2.8.5 (pacman -S nut)
• Скрипт завершения: /usr/local/bin/graceful-shutdown — останавливает Docker-контейнеры (SIGTERM, 60с), sync, systemctl poweroff
• Логика: питание пропало → ИБП на батарее → 10 минут (OFFDURATION 600) → graceful-shutdown → poweroff

Конфиги NUT

Сервисы (systemd)

nut-driver@apc-ups.service   enabled + active
nut-server.service           enabled + active
nut-monitor.service          enabled + active

Проверка

ssh mkair-server-tmn "upsc apc-ups"           # статус ИБП
ssh mkair-server-tmn "upsc apc-ups ups.status"  # OL = от сети, OB = батарея
ssh mkair-server-tmn "upsc apc-ups battery.charge"  # процент заряда
ssh mkair-server-tmn "journalctl -u nut-monitor -f"  # лог upsmon

NetBird MCP (machine management)

• Opencode has a built-in NetBird MCP tool (netbird MCP server).
• Requires NETBIRD_API_KEY env var (personal access token from NetBird dashboard).
• Available tools: list-peers, get-peer, get-peer-by-ip, rename-peer.
• Secrets: NETBIRD_API_KEY stored in ~/.config/zsh/secrets.zsh (encrypted via chezmoi+age). Source before starting opencode: source ~/.config/zsh/secrets.zsh