My Linux / macOS dotfiles.
require git, zsh, curl
git clone git@github.com:mjun0812/dotfiles.git ~/.dotfiles
cd~/.dotfiles
./install.sh
# First Install Only: Install VS Code extensions
./script/setup/install_vscode_extensions.sh
# First Install Only: For macOS
./script/setup/setup_macos_apps.sh
# Optional: Login to GitHub CLI
gh auth loginTo sync local app settings (macOS app defaults and the VS Code extension list) back into this repository, run:
./update.shIt dumps the settings and shows the resulting git status; review and commit the diff yourself. iTerm2 is not part of the dump: it reads and writes its settings directly in config/mac/iterm2/ via its custom preferences folder feature.
The shared agent skills and the code-reviewer agents are not managed in this repository. They are subscribed from mjun0812/skills via apm; the subscription is declared in config/ai-agents/apm.yml (symlinked to ~/.apm/apm.yml and applied with apm update -g -y by install.sh) and tracks the main branch.
# install.sh already runs this after linking apm.yml; run it again to# follow mjun0812/skills changes without re-running install.sh
apm update -gapm update -g re-resolves main, deploys the changed skills/agents, and removes deleted ones automatically (lockfile-based cleanup). Since the subscription tracks a branch, config/ai-agents/apm.yml does not change on updates — there is usually nothing to commit here.
Private skills (mjun-*, self-review) still live in config/ai-agents/skills/ and are symlinked by install.sh.
| Name | Description |
|---|---|
| zsh | Shell |
| mise | Package manager |
| Neovim | Editor |
| VSCode | IDE |
| Cursor | IDE |
| Name | Description |
|---|---|
| actionlint | GitHub Actions workflow linter |
| aqua | Declarative CLI version manager |
| aws-cli | AWS command-line interface |
| bat | Modern cat with syntax highlighting |
| delta | Git diff pager |
| eza | Modern ls |
| fd | Modern find |
| gh | GitHub CLI |
| ghq | Repository management |
| git-lfs | Git Large File Storage |
| gwq | Git worktree management |
| jq | JSON processor |
| kubectl | Kubernetes CLI |
| lazygit | Git TUI |
| pre-commit | Git commit hooks manager |
| prek | pre-commit runner in Rust |
| ripgrep | Modern grep |
| ripgrep-all | ripgrep for PDFs, archives, and docs |
| sheldon | Zsh plugin manager |
| shellcheck | Shell script linter |
| shfmt | Shell script formatter |
| starship | Cross-shell prompt |
| stylua | Lua formatter |
| tex-fmt | LaTeX formatter |
| tmux | Terminal multiplexer |
| tree-sitter | Parser generator tool |
| uv | Python package and tool manager |
| vp | Vite Plus CLI |
| yazi | Terminal file manager |
| yq | YAML processor |
| zoxide | Smart cd command |
| Name | Description |
|---|---|
| Claude Code | AI agent for daily use |
| Codex | AI agent for daily use |
| Antigravity-cli | AI agent for generate commit messages |
| Copilot-cli | AI agent for code |
| OpenCode | AI agent for code |
Agent skills (shared across Claude Code / Codex / Gemini / Antigravity) are documented in doc/skills.md.
Apps installed via Homebrew Cask. Details of configuration and keyboard shortcuts are documented in doc/macOS.md.
| Name | Description |
|---|---|
| AeroSpace | Tiling window manager |
| Alt-Tab | Windows-style window switcher |
| azooKey | Japanese input method |
| balenaEtcher | USB flash tool |
| BetterTouchTool | Input device customization |
| ChatGPT | OpenAI desktop client |
| Claude | Anthropic desktop client |
| Clipy | Clipboard manager |
| Cursor | AI-powered IDE |
| DeepL | Translator |
| Ghostty | Terminal emulator |
| Hammerspoon | macOS automation |
| Homerow | Keyboard-driven mouse replacement |
| Inkscape | Vector graphics editor |
| iTerm2 | Terminal emulator |
| Karabiner-Elements | Keyboard customization |
| Nani | Translator |
| Notion | Notes and knowledge base |
| Obsidian | Markdown knowledge base |
| Ollama | Local LLM runtime |
| Raycast | Launcher |
| Visual Studio Code | Code editor |
| WezTerm | Terminal emulator |
| XQuartz | X11 for macOS |
I prefer Tokyo Night color scheme. It is used in Neovim, VS Code, Cursor.
| Color | sRGB | Display-P3 |
|---|---|---|
| Foreground |  #EAEAEA | #EAEAEA |
| Background |  #000000 | #000000 |
| Black | #000000 | #000000 |
| Red |  #FE533E |  #EB6049 |
| Green |  #57DC76 |  #7DD981 |
| Yellow |  #FECB00 |  #F6CD45 |
| Blue |  #00A7FF |  #4AA5F8 |
| Magenta |  #FF4867 |  #EB576A |
| Cyan |  #69D1FA |  #84CFF6 |
| White | #EAEAEA | #EAEAEA |
| Gray |  #7B7B7B | #7B7B7B |
| Light Red | #FE533E | #EB6049 |
| Light Green | #57DC76 | #7DD981 |
| Light Yellow | #FECB00 | #F6CD45 |
| Light Blue | #00A7FF | #4AA5F8 |
| Light Magenta | #FF4867 | #EB576A |
| Light Cyan | #69D1FA | #84CFF6 |
| Light White | #EAEAEA | #EAEAEA |
# Show NVIDIA GPUs that are not used by Xorg or gnome
nvs
# Claude Code
cc-commit # AIが生成したコミットメッセージでコミットする
cc-commit-ja # AIが生成した日本語のコミットメッセージでコミットする# Gemini-cli
gemini-commit # AIが生成したコミットメッセージでコミットする
gemini-commit-ja # AIが生成した日本語のコミットメッセージでコミットする# Codex
codex-commit # AIが生成したコミットメッセージでコミットする
codex-commit-ja # AIが生成した日本語のコミットメッセージでコミットする# Copilot-cli
copilot-commit # AIが生成したコミットメッセージでコミットする
copilot-commit-ja # AIが生成した日本語のコミットメッセージでコミットする# Antigravity-cli
agy-commit # AIが生成したコミットメッセージでコミットする
agy-commit-ja # AIが生成した日本語のコミットメッセージでコミットする# zoxide + fzf# zoxideの履歴をfzfで選択してcdする# Ctrl+f でも同様の操作が可能
fzf-zoxide-cd
# ghq + fzf# ghqで管理しているリポジトリをfzfで選択してcdする# cd for ghq repository
cd_repo
# Ctrl+] でも同様の操作が可能# gwq + fzf# gwqで管理しているワークツリーをfzfで選択してcdする# cd git worktree with gwq# cd for git worktree
cd_gwq# Delete local branches that are deleted and merged
git prune-branch
# commit with AI generated commit message
git aicommit
# commit with AI generated commit message in Japanese
git aicommit-jaThis dotfiles uses mise as a package manager for CLI tools.
If you want to search and add a new tool, you can use below commands.
# Search for a tool in the mise registry
mise registry | grep <tool-name># Search for a tool in aqua registry
aqua g
mise use aqua:google-antigravity/antigravity-cli@latest- macOS:
headroom-proxy,cli-proxy-api, andcodex-remote-controlas LaunchAgents - Linux:
codex-remote-controlas a systemd user service
# macOS
mise bootstrap macos launchd-agents status
mise bootstrap macos launchd-agents apply --yes
# Linux
mise bootstrap linux systemd-units status
mise bootstrap linux systemd-units apply --yes
# Restart# macOS
mise bootstrap macos launchd-agents apply --yes
# Linux
mise bootstrap linux systemd-units apply --yesSee doc/nvim.md for Neovim configuration and keyboard shortcuts.
VS Code extensions are managed in config/vscode/extensions.txt.
script/setup/install_vscode_extensions.sh installs missing extensions only and does not uninstall local extensions.
To synchronize the installed extensions exactly with config/vscode/extensions.txt, run:
script/tools/sync_vscode_extensions.shYou can pass another extension list:
script/tools/sync_vscode_extensions.sh path/to/extensions.txtUse --dry-run to preview installs and uninstalls without changing VS Code:
script/tools/sync_vscode_extensions.sh --dry-run
script/tools/sync_vscode_extensions.sh --dry-run path/to/extensions.txt