dotfiles

How to setup

The easiest way to install the dotfiles is open to up a terminal, type the installation command below:

curl -L https://dot.ryosan470.com | python

Update the configuration

Use dot command as below:

$ dot
The dot command is a controller my dotfiles based on CLI
There are common dot commands used in various situations:

update         Update your dotfiles from GitHub (e.g git fetch origin master)
help           Print this message

Dependencies

• zsh
  • zimfw
• tmux
  • tmux plugin manager

Customization

You can customize the dotfiles by editing the files in the ~/.local.zsh. For example, you can set your own aliases, functions, and environment variables.

# ~/.local.zsh
# Set your own aliases
alias ll='ls -la'

Periodic cache cleanup (macOS)

launchd/cleanup-caches.sh cleans up regenerable development caches (go build cache, uv, Homebrew, pnpm, npm, mise, dangling docker images/build cache). It runs on the 1st of every month at 12:00 via launchd. Logs are written to ~/Library/Logs/cleanup-caches.log.

# Install / update the LaunchAgent
sed "s|__HOME__|$HOME|g" ~/.dotconfig/dotfiles/launchd/com.ryosan470.cleanup-caches.plist \
  > ~/Library/LaunchAgents/com.ryosan470.cleanup-caches.plist
launchctl bootout gui/$(id -u)/com.ryosan470.cleanup-caches 2>/dev/null
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.ryosan470.cleanup-caches.plist

# Run it now
launchctl kickstart gui/$(id -u)/com.ryosan470.cleanup-caches

# Uninstall
launchctl bootout gui/$(id -u)/com.ryosan470.cleanup-caches
rm ~/Library/LaunchAgents/com.ryosan470.cleanup-caches.plist

Development

Running Tests

This project uses uv for Python dependency management and testing.

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies
uv sync --dev

# Run tests
uv run pytest

# Run tests with coverage
uv run pytest --cov=install --cov-report=term-missing

# Run specific test
uv run pytest tests/test_install.py::TestWhichFunction -v

Code Quality

This project uses Ruff for linting and formatting.

# Run linter
uv run ruff check .

# Auto-fix linting issues
uv run ruff check --fix .

# Format code
uv run ruff format .

# Check formatting without making changes
uv run ruff format --check .