sync

2026-09-07 11:52:50 -06:00
parent d554c64d00
commit d304fd0e6e
11 changed files with 975 additions and 25 deletions
@@ -0,0 +1,81 @@
+# chezmoi
+
+[chezmoi](https://www.chezmoi.io/) is a dotfile manager that keeps configuration files synchronized across machines using a git-backed source directory.
+
+## Setup
+
+### Configuration
+
+Config file: `~/.config/chezmoi/chezmoi.toml`
+
+```toml
+[git]
+    autoCommit = true
+    autoPush = true
+
+[merge]
+command = "bash"
+args = [
+    "-c",
+    "cp {{ .Target | quote }} {{ printf \"%s.base\" .Target | quote }} && code --new-window --wait --merge {{ .Destination | quote }} {{ .Target | quote }} {{ printf \"%s.base\" .Target | quote }} {{ .Source | quote }}",
+]
+```
+
+- **autoCommit**: Automatically commits changes after `chezmoi apply`
+- **autoPush**: Automatically pushes to remote after commit
+- **merge**: Custom merge command using VS Code's merge editor
+
+### Source Directory
+
+`~/.local/share/chezmoi/` - Git repository containing managed dotfiles
+
+## Managed Dotfiles
+
+| File/Directory | Description |
+|----------------|-------------|
+| `.bash_aliases` | Shell aliases |
+| `.bashrc` | Bash configuration |
+| `.tmux.conf` | Tmux configuration |
+| `.config/opencode/` | OpenCode AI assistant config |
+| `.gemini/settings.json` | Gemini CLI settings |
+| `.ssh/authorized_keys` | SSH authorized keys (private) |
+
+### OpenCode Config
+
+The `.config/opencode/` directory includes:
+- `opencode.jsonc` - Main OpenCode configuration
+- `oh-my-opencode-slim.json` - Slim preset configuration
+- `executable_opencode-tmux-launch.sh` - Script to launch OpenCode in tmux
+
+## Common Commands
+
+```bash
+# Edit a dotfile in the source directory
+chezmoi edit ~/.bashrc
+
+# Apply changes to the home directory
+chezmoi apply
+
+# See what would change
+chezmoi diff
+
+# Add a new file to chezmoi
+chezmoi add ~/.newconfig
+
+# Edit the config file
+chezmoi edit-config
+
+# Initialize chezmoi on a new machine
+chezmoi init https://github.com/username/dotfiles.git
+```
+
+## Workflow
+
+1. Edit dotfiles with `chezmoi edit` (opens source file)
+2. Apply changes with `chezmoi apply`
+3. Changes auto-commit and push to git remote
+
+## Related
+
+- [[homelab]]
+- [[dev environments]]