GitHub - mjun0812/dotfiles: My dotfiles for macOS and Linux

My Linux / macOS dotfiles.

Install

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 login

Update

To sync local app settings (macOS app defaults and the VS Code extension list) back into this repository, run:

./update.sh

Agent Skills / Agents (apm)

apm update -g

Tools

Name	Description
zsh	Shell
mise	Package manager
Neovim	Editor
VSCode	IDE
Cursor	IDE

CLI

Name	Description
actionlint	GitHub Actions workflow linter
agent-browser	Browser automation CLI for AI agents
apm	Agent package manager
aqua	Declarative CLI version manager
aws-cli	AWS command-line interface
bat	Modern `cat` with syntax highlighting
CLIProxyAPI	OpenAI/Gemini/Claude compatible API proxy for AI CLIs
cmake	Build system generator
container	Linux containers in lightweight VMs (macOS)
copier	Project template generator
delta	Git diff pager
duckdb	In-process analytical SQL database
dust	Modern `du`
eza	Modern `ls`
fd	Modern `find`
fzf	Fuzzy finder
gh	GitHub CLI
git-lfs	Git Large File Storage
gitleaks	Secret scanner
glances	System monitor
headroom	Token-compressing proxy for coding agents
herdr	Terminal multiplexer for coding agents
huggingface_hub	Hugging Face Hub CLI (`hf`)
hunk	Review-first terminal diff viewer
imagemagick	Image processing
jq	JSON processor
keychain	ssh-agent / gpg-agent manager
kubectl	Kubernetes CLI
mactop	Apple Silicon monitor (macOS)
md-to-pdf	Markdown to PDF converter
mermaid-cli	Mermaid diagram renderer (`mmdc`)
ninja	Build system
nvitop	NVIDIA GPU process viewer
oxfmt	JS/TS/Markdown/JSON/YAML formatter
oxlint	JS/TS linter
pnpm	Node.js package manager
powershell	PowerShell (macOS)
prek	pre-commit runner in Rust
prettier	Code formatter
pyright	Python type checker and language server
resvg	SVG renderer (macOS)
ripgrep	Modern `grep`
ripgrep-all	`ripgrep` for PDFs, archives, and docs
rtk	Token-reducing CLI proxy for LLMs
ruff	Python linter and formatter
runpodctl	RunPod CLI
sheldon	Zsh plugin manager
shellcheck	Shell script linter
shfmt	Shell script formatter
starship	Cross-shell prompt
stylua	Lua formatter
swiftlint	Swift linter (macOS)
taplo	TOML formatter
tex-fmt	LaTeX formatter
tmux	Terminal multiplexer
tree-sitter	Parser generator tool
ty	Python type checker
typescript	TypeScript compiler
typescript-language-server	TypeScript language server
usage	CLI specification tool
uv	Python package and tool manager
vp	Vite Plus CLI
yobirin	Interactive notification CLI (macOS)
yq	YAML processor
zoxide	Smart `cd` command

AI Agents

Name	Description
Claude Code	AI agent for daily use
Codex	AI agent for daily use
Antigravity-cli	AI agent for generate commit messages
OpenCode	AI agent for code

Agent skills (shared across Claude Code / Codex / Gemini / Antigravity) are documented in doc/skills.md.

macOS Apps

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
BetterDisplay	Display management
BetterTouchTool	Input device customization
ChatGPT	OpenAI desktop client
Claude	Anthropic desktop client
Clipy	Clipboard manager
CodexBar	Menu bar usage monitor for agents
Cursor	AI-powered IDE
DeepL	Translator
Discord	Chat
draw.io	Diagram editor
Ghostty	Terminal emulator
Hammerspoon	macOS automation
Homerow	Keyboard-driven mouse replacement
Inkscape	Vector graphics editor
iTerm2	Terminal emulator
Karabiner-Elements	Keyboard customization
KeyCastr	Keystroke visualizer
MacTeX (no GUI)	LaTeX distribution
Miraktest	Mirakurun TV client
Nani	Translator
Notion	Notes and knowledge base
Obsidian	Markdown knowledge base
Ollama	Local LLM runtime
OmniWM	Tiling window manager
Raycast	Launcher
Thaw	Menu bar manager
Visual Studio Code	Code editor
WezTerm	Terminal emulator
XQuartz	X11 for macOS

Design

I prefer Tokyo Night color scheme.

Terminal color schemes

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`

Alias

# Show NVIDIA GPUs that are not used by Xorg or gnome
nvs

# Claude Code
cc-commit # AIが生成したコミットメッセージでコミットする
cc-commit-ja # AIが生成した日本語のコミットメッセージでコミットする

# Gemini-cli (agy-commit / agy-commit-ja の別名)
gemini-commit # AIが生成したコミットメッセージでコミットする
gemini-commit-ja # AIが生成した日本語のコミットメッセージでコミットする

# Codex
codex-commit # AIが生成したコミットメッセージでコミットする
codex-commit-ja # AIが生成した日本語のコミットメッセージでコミットする

# Antigravity-cli
agy-commit # AIが生成したコミットメッセージでコミットする
agy-commit-ja # AIが生成した日本語のコミットメッセージでコミットする

# zoxide + fzf
# zoxideの履歴をfzfで選択してcdする
# Ctrl+f でも同様の操作が可能
fzf-zoxide-cd

Git Commands

# 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-ja

mise

This dotfiles uses mise as a package manager for CLI tools.

mise bootstrap services

mise bootstrap services status
mise bootstrap services apply --yes

Neovim

See doc/nvim.md for Neovim configuration and keyboard shortcuts.

VSCode

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.sh

You can pass another extension list:

script/tools/sync_vscode_extensions.sh path/to/extensions.txt

Use --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

Name		Name	Last commit message	Last commit date
.github		.github
assets		assets
config		config
doc		doc
script		script
templates		templates
.editorconfig		.editorconfig
.gitignore		.gitignore
.oxfmtrc.json		.oxfmtrc.json
.pre-commit-config.yaml		.pre-commit-config.yaml
CLAUDE.md		CLAUDE.md
README.md		README.md
install.sh		install.sh
update.sh		update.sh

Navigation Menu

Repository files navigation

Install

Update

Tools

CLI

AI Agents

macOS Apps

Design

Terminal color schemes

Alias

Git Commands

mise

mise bootstrap services

Neovim

VSCode

About

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Install

Update

Tools

CLI

AI Agents

macOS Apps

Design

Terminal color schemes

Alias

Git Commands

mise

mise bootstrap services

Neovim

VSCode

About

Resources

Stars

Watchers

Forks

Contributors

Languages