optimEnv

Cross-platform terminal optimization with modern Rust/Go CLI tools.

What's Included

Modern CLI Replacements

Traditional	Modern	Speed	Description
ls	eza	~2x	Icons, colors, git status
cat	bat	-	Syntax highlighting
find	fd	~5x	Simpler syntax, respects .gitignore
grep	ripgrep	~10x	Blazingly fast search
diff	delta	-	Beautiful git diffs
du	dust	~2x	Visual disk usage
top	btm	-	Modern system monitor
man	tldr	-	Practical examples

Productivity Tools

• fzf - Fuzzy finder (Ctrl+R for history, Ctrl+T for files)
• starship - Fast, customizable prompt
• lazygit - Terminal UI for git

Installation

Ubuntu / WSL2

git clone https://github.com/cherishmey/optimEnv.git
cd optimEnv
chmod +x scripts/install-ubuntu.sh
./scripts/install-ubuntu.sh

Windows (Git Bash)

git clone https://github.com/cherishmey/optimEnv.git
cd optimEnv
powershell -ExecutionPolicy Bypass -File scripts/install-windows.ps1

macOS

git clone https://github.com/cherishmey/optimEnv.git
cd optimEnv
chmod +x scripts/install-mac.sh
./scripts/install-mac.sh

VPS / Cloud Server (Headless)

For headless Ubuntu servers with Homebrew already installed:

git clone https://github.com/cherishmey/optimEnv.git
cd optimEnv
chmod +x scripts/install-vps.sh
./scripts/install-vps.sh

No fonts needed for headless servers. See environments/vps-clawdbot.md for a full VPS setup example.

Post-Installation

1. Restart your terminal
2. Set the Nerd Font in your terminal settings:
   • Windows Terminal: Settings → Profiles → Font face → Sarasa Term K Nerd Font
   • Warp: Settings → Appearance → Font → Sarasa Term K Nerd Font
   • iTerm2: Preferences → Profiles → Text → Font → Sarasa Term K Nerd Font
3. Test: ll, cat ~/.bashrc, lg

Note: Sarasa Gothic is used instead of JetBrainsMono for full CJK (Korean, Japanese, Chinese) character support.

Aliases

File Operations

Alias	Command
ll	eza -la --icons --git
la	eza -a --icons
lt	eza --tree --level=2
cat	bat --paging=never

Git

Alias	Command
gs	git status -sb
gd	git diff
glog	git log --oneline --graph
lg	lazygit

Navigation

Alias	Command
..	cd ..
...	cd ../..

Structure

optimEnv/
├── shell/
│   ├── aliases.sh          # Shared aliases (cross-platform)
│   ├── bashrc.ubuntu.sh    # Ubuntu/WSL2 Bash config
│   ├── bashrc.windows.sh   # Windows Git Bash config
│   ├── bashrc.mac.sh       # macOS Bash config
│   └── zshrc.mac.sh        # macOS Zsh config
├── git/
│   └── .gitconfig          # Git config with delta
├── starship/
│   └── starship.toml       # Prompt configuration
└── scripts/
    ├── install-ubuntu.sh
    ├── install-windows.ps1
    └── install-mac.sh

Customization

Add Custom Aliases

Edit shell/aliases.sh for cross-platform aliases, or the platform-specific files for OS-specific ones.

Modify Prompt

Edit starship/starship.toml. See Starship docs.

Change Git Diff Theme

Edit delta theme in git/.gitconfig:

[delta]
    syntax-theme = Dracula  # or: Nord, GitHub, OneHalfDark

Claude Code Configuration

This repo includes Claude Code agents, commands, and rules that sync across devices via symlinks.

Setup (New Device)

# After cloning optimEnv, create symlinks:
ln -sf ~/path/to/optimEnv/claude/agents ~/.claude/agents
ln -sf ~/path/to/optimEnv/claude/commands ~/.claude/commands
ln -sf ~/path/to/optimEnv/claude/rules ~/.claude/rules

Note: settings.json, hooks/, and CLAUDE.md remain device-specific (not symlinked).

What's Included

Directory	Contents
claude/agents/	Custom agents (architect, planner, build-error-resolver, etc.)
claude/commands/	Slash commands (/refactor-clean, /build-fix, /architecture-review)
claude/rules/	Workflow rules (task-management, communication, constraints, etc.)