Skip to content
kxgcayhPublic
forked from craftzdog/dotfiles

About

My personal dotfiles

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

327 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nvim screenshot

Kautsar's dotfiles

Forked from craftzdog/dotfiles by Takuya Matsuyama, with my own tweaks on top.

Warning: Don’t blindly use these settings unless you know what that entails. Use at your own risk!

Changes from upstream

  • Vesper theme everywhere: Ghostty (Vesper, background blur kept), Neovim (vesper.nvim, transparent), and herdr (vesper). The custom Neovim tabline uses the Vesper palette instead of Solarized Osaka.
  • oh-my-zsh style shortcuts in fish:
    • plugin-git for the oh-my-zsh git aliases (gst, gco, gcm, …)
    • conf.d/abbr.fish: abbreviations ported from the oh-my-zsh flutter, npm, opencode and vscode plugins (flr, flget, npmrd, opc, vsc, …)
  • Neovim tweaks:
    • ;f uses the snacks smart picker with frecency (buffers, recent and project files, like VS Code's Cmd+P); ;F is the plain file finder
    • Up/Down select items in the cmdline completion menu; Option+Left/Right move by word in insert mode
    • flutter-tools.nvim with keymaps under <leader>F (Fd device, Fr run, Fl reload, FR restart, Fq quit, Fg log, Fo outline, Ft DevTools)
  • Flutter via fvm: fvm and cocoapods in the Brewfile; fish wraps flutter and dart to run through fvm, and flutter-tools.nvim uses the project's .fvm/flutter_sdk.
  • Node via mise: node = "lts" in the mise config.
  • Machine-specific settings (paths, SDKs, API keys) live in ~/.config/fish/config-local.fish, which chezmoi ignores, so they never enter this repo.

Install

brew install chezmoi
chezmoi init --apply kxgcayh

chezmoi init asks for your name, email and GitHub username to fill in the git config. Applying also installs the Brewfile, global npm packages and fisher plugins.

On macOS, setup also sets Fish as your default login shell. It may ask for your Mac login password to register Fish in /etc/shells and change the shell. This step runs once per machine and skips the change if Fish is already the default. Log out and back in afterward, or run exec fish in your current terminal.

To pull in upstream changes:

git remote add upstream https://github.com/craftzdog/dotfiles.git  # once
git fetch upstream && git merge upstream/master

Contents

Managed with chezmoi.

  • Neovim config
  • herdr config (terminal workspace manager for AI agents)
  • tmux config
  • Ghostty config
  • git and lazygit config
  • fish config
  • PowerShell config
  • Homebrew, apt, Scoop and winget package lists

Neovim setup

Requirements

  • Neovim >= 0.12 (plugins are managed with the built-in vim.pack)
  • Git
  • lazygit (optional)
  • tree-sitter CLI and a C compiler for nvim-treesitter
  • for the snacks.nvim picker:
  • a terminal that supports true color and undercurl, such as Ghostty
  • vesper.nvim
  • Flutter SDK (installed with fvm) for flutter-tools.nvim (optional)

Terminal setup

  • Ghostty - Terminal emulator
  • herdr - Workspace manager for running AI coding agents side by side, with tmux-style keybindings (prefix ctrl+t)
  • tmux - Terminal multiplexer

Fonts

Installed as Homebrew casks from the Brewfile:

Shell setup (macOS & Linux)

PowerShell setup (Windows)

How to use

Takuya's video tutorials explain the original setup:

  1. My Neovim setup
  2. My dev workflow using tmux and vim
  3. A productive command-line Git workflow for indie app developers
  4. My Fish shell workflow for coding
  5. How to set up PowerShell prompt with Oh My Posh on Windows 11

Credits

Original dotfiles by Takuya Matsuyama (craftzdog):

Zsh restore and local settings

The Zsh backup includes Powerlevel10k settings. Install Oh My Zsh and the Powerlevel10k theme separately, plus the plugins listed in .zshrc: zsh-autosuggestions, zsh-syntax-highlighting, and zsh-interactive-cd. Built-in plugins come with Oh My Zsh. NVM, jenv, Android SDK, and FVM need their usual setup before their shell integration is useful.

Before restoring .zshrc, move credentials, custom volume paths, compiler flags, Windows cross-compilation variables, AI command wrappers, and other machine overrides from your current shell file into unmanaged ~/.zshrc.local. The managed shell sources this file first, before the instant prompt and plugin initialization. Keep local secrets out of Git. PUB_CACHE and EXT_DRIVE belong there if used; portable home paths use $HOME in the backup. Review chezmoi diff before applying, and keep a private copy of your old shell settings.

The Brewfile preserves existing entries and adds installed tools and fonts. Explicit additions exclude mingw-w64, xwin, qt, llvm, omp, xmake, deskflow, dotnet-sdk, and mac-sai. Homebrew can still install excluded tools as dependencies.

Devault sync (macOS)

~/.local/bin/devault-sync exports ai-memory session notes and rebuilds vault indexes. The LaunchAgent runs every five minutes and at login. The installation hook reloads the agent when its script or plist changes. Restoring these files with chezmoi will activate that agent; inspect the proposed changes first. Python 3 and an existing Obsidian vault are required. No vault content is backed up here.

Keep the vault location in unmanaged ~/.config/devault/config.json using the vault field; optionally set ai_memory there for a custom ai-memory data root. Alternatively the script recognizes DEVAULT_VAULT and AI_MEMORY_DATA_DIR, or finds a vault named Devault in Obsidian's local settings. launchd does not inherit interactive shell settings, so prefer the JSON configuration for the agent. Use devault-sync --where to inspect the chosen vault and --dry-run to preview writes. Logs and state live in ~/.local/state/devault-sync/.

Backup checks

Install pre-commit and Gitleaks separately, then run pre-commit install in this repository. The configured hook scans for secrets and literal personal home or volume paths in changed configuration. CI runs the same path check and Gitleaks. Local overrides and AI configuration should stay outside the backup.

About

My personal dotfiles

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages