Dotfiles

Personal dotfiles plus a small agent-readiness layer for Claude Code / Codex CLI terminal work.

Agent readiness

The goal is environment correctness before prompt tuning: make the terminal predictable, non-interactive, and easy for coding agents to inspect.

1. Diagnose

bin/agent-env-doctor
bin/agent-env-doctor --json

The doctor is read-only. It checks:

• PATH and login-shell PATH drift
• agent CLI binaries
• curated agent tools from agents/tools.json
• shell quoting smoke tests
• MCP config parseability and stdio command exposure
• instruction-file presence and size

2. Install curated tools

Dry-run first:

agents/install.sh --dry-run

Install from official distro packages only:

agents/install.sh

Optional config layer:

agents/install.sh --apply-configs

--apply-configs copies the small config files into ~/.config/agent-env and prints loader snippets. It does not silently edit .zshrc, .gitconfig, or tmux files.

3. Use the config layer

After --apply-configs, opt in from the relevant environment:

source ~/.config/agent-env/env.sh
git config --global include.path ~/.config/agent-env/gitconfig-agent
tmux source-file ~/.config/agent-env/tmux-agent.conf

The configs intentionally disable pagers/color where possible, set non-interactive editor defaults, and make tmux quiet but durable.

Repository structure

File	Purpose
.zshrc	Zsh shell configuration
.zprofile	Zsh profile configuration
.gitconfig	Git configuration
.config/kaku/	Kaku configuration framework
bin/agent-env-doctor	Read-only agent environment doctor
agents/TOOLS.md	Curated/rejected CLI tool rationale
agents/tools.json	Doctor manifest for curated tool checks
agents/install.sh	Idempotent installer with required --dry-run support
agents/configs/	Small opt-in terminal config layer for agents
settings.jar	IntelliJ/JetBrains IDE settings export

Original setup

1. Clone this repo: git clone https://github.com/jingchaodev/.dotfiles ~/.dotfiles
2. Symlink files:

ln -sf ~/.dotfiles/.zshrc ~/.zshrc
ln -sf ~/.dotfiles/.zprofile ~/.zprofile
ln -sf ~/.dotfiles/.gitconfig ~/.gitconfig
mkdir -p ~/.config
ln -sf ~/.dotfiles/.config/kaku ~/.config/kaku

iTerm2 setup

Preferences are stored in iterm2/com.googlecode.iterm2.plist.

To sync: Open iTerm2 → Settings > General > Preferences → Check "Load preferences from a custom folder or URL" → Select the ~/.dotfiles/iterm2 folder.